Markdown är ett skrivformat; HTML är ett publiceringsformat. Markdown-syntaxen är alltså inte avsedd att erbjuda HTMLs fulla mångsidighet, bara de vanligaste elementen för skriven text. När du behöver göra något mer komplicerat kan du använda alla inline HTML-taggar och blocknivåtaggar som stöds av DevSite i en Markdown-fil. Det finns ingen anledning att ange att du byter från Markdown till HTML, använd bara HTML-taggen som i exemplet nedan.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Inline HTML
Inline HTML-taggar kan användas i ett Markdown-stycke, listobjekt eller rubrik, och de kan också innehålla Markdown-syntax (t.ex. **strong** , *emphasis* , etc.) Detta är användbart när du vill uppmärksamma lite kod, som i exemplet nedan.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML på blocknivå
HTML-taggar på blocknivå som stöds av DevSite måste separeras från omgivande innehåll med en tom rad. Och till skillnad från inline HTML-taggar, renderas inte Markdown-syntax (t.ex. **strong** , *emphasis* , etc.) i HTML-taggar på blocknivå som i exemplet nedan.
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.
Bästa metoder
Vi rekommenderar att formatera HTML i Markdown-filer på följande sätt för att förhindra renderingsfel på DevSite.
Använd inte HTML-taggar på blocknivå som inte stöds. DevSite stöder många HTML-taggar på blocknivå; men att inkludera en som inte stöds kommer antingen att rendera din HTML som text eller bryta koden.
Lägg inte till extra tabbar eller mellanslag vid indrag Start- och sluttaggar på blocknivå ska inte dras in med tabbar eller mellanslag. Vissa redigerare lägger automatiskt till extra flikar eller mellanslag – se upp!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Glöm inte att oindragen kod är relativ
Du behöver till exempel inte dra in start- och sluttaggar på blocknivå när du skapar listor i Markdown.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Lägg inte till en tom rad mellan en start- och sluttagg
Detta är lätt att göra när du växlar mellan Markdown och HTML, men en enkel tom rad kan lätt göra en sida felaktigt.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.