Markdown je zapisni format; HTML je oblika objavljanja. Tako sintaksa Markdown ni mišljena, da bi ponudila celotno vsestranskost HTML, ampak samo najpogostejše elemente za pisno besedilo. Ko morate narediti nekaj bolj zapletenega, lahko v datoteki Markdown uporabite katero koli vgrajeno oznako HTML in oznake na ravni bloka, ki jih podpira DevSite. Ni vam treba navesti, da preklopite z Markdown na HTML, samo uporabite oznako HTML kot v spodnjem primeru.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Vgrajeni HTML
Vgrajene oznake HTML se lahko uporabljajo znotraj odstavka Markdown, elementa seznama ali glave in lahko vsebujejo tudi sintakso Markdown (npr. **strong** , *emphasis* itd.) To je koristno, če želite pritegniti pozornost košček kode, kot v spodnjem primeru.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML na ravni bloka
Oznake HTML na ravni bloka, ki jih podpira DevSite, morajo biti ločene od okoliške vsebine s prazno vrstico. Za razliko od vgrajenih oznak HTML sintaksa Markdown (npr. **strong** , *emphasis* itd.) v oznakah HTML na ravni bloka ni upodobljena kot v spodnjem primeru.
This is a Markdown paragraph that explains Java format strings:
// required blank line
<pre>
System.out.format("The square of *%d* is *%f*.*%n*", i, r);
</pre>
// required blank line
This is another Markdown paragraph.
Najboljše prakse
Priporočamo, da formatirate HTML v datotekah Markdown na naslednje načine, da preprečite napake pri upodabljanju na DevSite.
Ne uporabljajte nepodprtih oznak HTML na ravni blokov DevSite podpira številne oznake HTML na ravni blokov; vendar vključitev nepodprtega bo bodisi upodobila vaš HTML kot besedilo ali zlomila kodo.
Pri zamiku ne dodajajte dodatnih zavihkov ali presledkov. Začetne in končne oznake na ravni bloka ne smejo biti zamaknjene z zavihki ali presledki. Nekateri urejevalniki samodejno dodajo dodatne zavihke ali presledke – pozor!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Ne pozabite, da je nezamaknjena koda relativna
Na primer, pri ustvarjanju seznamov v Markdown vam ni treba zamikati začetnih in končnih oznak na ravni bloka.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Med začetno in končno oznako ne dodajajte prazne vrstice
To je enostavno storiti, ko preklapljate med Markdown in HTML, vendar lahko preprosta prazna vrstica zlahka nepravilno upodablja stran.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.