Markdown je format pisanja; HTML je format za objavljivanje. Stoga Markdown sintaksa nije namijenjena ponudi pune svestranosti HTML-a, samo najčešćih elemenata za pisani tekst. Kada trebate učiniti nešto kompliciranije, možete koristiti bilo koju ugrađenu HTML oznaku i oznake na razini bloka koje podržava DevSite u Markdown datoteci. Nema potrebe označavati da se prebacujete s Markdowna na HTML, samo upotrijebite HTML oznaku kao u primjeru u nastavku.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Inline HTML
Umetnute HTML oznake mogu se koristiti unutar Markdown odlomka, stavke popisa ili zaglavlja, a također mogu sadržavati Markdown sintaksu (npr. **strong** , *emphasis* itd.) Ovo je korisno kada želite skrenuti pozornost na malo koda, kao u primjeru u nastavku.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML na razini bloka
HTML oznake na razini bloka koje podržava DevSite moraju biti odvojene od okolnog sadržaja praznim retkom. Za razliku od ugrađenih HTML oznaka, Markdown sintaksa (npr. **strong** , *emphasis* itd.) u HTML oznakama na razini bloka ne prikazuje se kao u primjeru u nastavku.
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.
Najbolje prakse
Preporučujemo formatiranje HTML-a u Markdown datotekama na sljedeće načine kako biste spriječili pogreške pri prikazivanju na DevSite.
Ne koristite nepodržane HTML oznake na razini bloka DevSite podržava mnoge HTML oznake na razini bloka; ali uključivanje nepodržanog će ili prikazati vaš HTML kao tekst ili će pokvariti kôd.
Nemojte dodavati dodatne tabulatore ili razmake prilikom uvlačenja Početne i završne oznake na razini bloka ne smiju biti uvučene tabulatorima ili razmacima. Neki uređivači automatski dodaju dodatne kartice ili razmake — pazite!
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 zaboravite da je neuvučeni kod relativan
Na primjer, ne morate uvlačiti početne i završne oznake na razini bloka kada stvarate popise u Markdownu.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Nemojte dodavati prazan redak između početne i završne oznake
To je lako učiniti kada se prebacujete između Markdowna i HTML-a, ali jednostavan prazan redak može lako prikazati stranicu netočno.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.