Markdown je formát zápisu; HTML je publikační formát. Syntaxe Markdown tedy nemá nabízet plnou všestrannost HTML, pouze nejběžnější prvky pro psaný text. Když potřebujete udělat něco složitějšího, můžete v souboru Markdown použít libovolnou vloženou značku HTML a značky na úrovni bloku, které DevSite podporuje. Není třeba uvádět, že přecházíte z Markdown na HTML, stačí použít značku HTML jako v příkladu níže.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Inline HTML
Vložené značky HTML lze použít v odstavci, položce seznamu nebo záhlaví Markdown a mohou také obsahovat syntaxi Markdown (např. **strong** , *emphasis* atd.) To je užitečné, když chcete upozornit na trochu kódu, jako v příkladu níže.
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, které jsou podporovány webem DevSite, musí být odděleny od okolního obsahu prázdným řádkem. A na rozdíl od vložených značek HTML se syntaxe Markdown (např. **strong** , *emphasis* atd.) v značkách HTML na úrovni bloku nevykresluje jako v příkladu níže.
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.
Nejlepší postupy
Doporučujeme formátovat HTML v souborech Markdown následujícími způsoby, abyste zabránili chybám při vykreslování na webu DevSite.
Nepoužívejte nepodporované značky HTML na úrovni bloku DevSite podporuje mnoho značek HTML na úrovni bloku; ale zahrnutí nepodporovaného kódu buď vykreslí váš HTML jako text, nebo poruší kód.
Při odsazování nepřidávejte další tabulátory ani mezery. Počáteční a koncové značky na úrovni bloku by neměly být odsazeny tabulátory nebo mezerami. Někteří editoři automaticky přidávají další tabulátory nebo mezery – 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.
Nezapomeňte, že neodsazený kód je relativní
Například při vytváření seznamů v Markdown nemusíte odsazovat počáteč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
Nepřidávejte prázdný řádek mezi počáteční a koncovou značku
To je snadné, když přepínáte mezi Markdown a HTML, ale jednoduchý prázdný řádek může snadno vykreslit stránku nesprávně.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.