Markdown je formát písania; HTML je publikačný formát. Syntax Markdown teda nemá ponúkať plnú všestrannosť HTML, len najbežnejšie prvky pre písaný text. Keď potrebujete urobiť niečo zložitejšie, môžete použiť ľubovoľnú vloženú značku HTML a značky na úrovni bloku, ktoré podporuje DevSite v súbore Markdown. Nie je potrebné uvádzať, že prechádzate z Markdown na HTML, stačí použiť značku HTML ako v príklade nižšie.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Inline HTML
Vložené značky HTML možno použiť v odseku Markdown, položke zoznamu alebo hlavičke a môžu tiež obsahovať syntax Markdown (napr. **strong** , *emphasis* atď.) Toto je užitočné, keď chcete upozorniť na trochu kódu, ako v príklade nižšie.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML na úrovni bloku
Značky HTML na úrovni bloku, ktoré sú podporované službou DevSite, musia byť oddelené od okolitého obsahu prázdnym riadkom. A na rozdiel od vložených značiek HTML sa syntax Markdown (napr. **strong** , *emphasis* atď.) v značkách HTML na úrovni bloku nevykresľuje ako v príklade nižšie.
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.
Osvedčené postupy
Odporúčame formátovať HTML v súboroch Markdown nasledujúcimi spôsobmi, aby ste predišli chybám vykresľovania na DevSite.
Nepoužívajte nepodporované značky HTML na úrovni bloku DevSite podporuje mnoho značiek HTML na úrovni bloku; ale zahrnutie nepodporovaného kódu buď vykreslí váš HTML ako text, alebo poruší kód.
Pri odsadzovaní nepridávajte ďalšie tabulátory ani medzery. Začiatočné a koncové značky na úrovni bloku by nemali byť odsadené tabulátormi alebo medzerami. Niektorí editori automaticky pridávajú ďalšie karty alebo medzery – 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.
Nezabudnite, že neodsadený kód je relatívny
Napríklad pri vytváraní zoznamov v Markdown nemusíte odsadzovať počiatočné a koncové značky na úrovni bloku.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Medzi počiatočnú a koncovú značku nepridávajte prázdny riadok
Je to jednoduché, keď prepínate medzi Markdown a HTML, ale jednoduchý prázdny riadok môže ľahko vykresliť stránku nesprávne.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.