Markdown er et skriveformat; HTML er et udgivelsesformat. Det er således ikke meningen, at Markdown-syntaksen skal tilbyde HTMLs fulde alsidighed, kun de mest almindelige elementer til skrevet tekst. Når du skal gøre noget mere kompliceret, kan du bruge ethvert inline HTML-tag og tags på blokniveau, der understøttes af DevSite i en Markdown-fil. Der er ingen grund til at angive, at du skifter fra Markdown til HTML, bare brug HTML-tagget som i eksemplet nedenfor.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Inline HTML
Inline HTML-tags kan bruges i et Markdown-afsnit, listeelement eller overskrift, og de kan også indeholde Markdown-syntaks (f.eks. **strong** , *emphasis* osv.) Dette er nyttigt, når du vil henlede opmærksomheden på lidt kode, som i eksemplet nedenfor.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML på blokniveau
HTML-tags på blokniveau, der understøttes af DevSite, skal adskilles fra omgivende indhold med en tom linje. Og i modsætning til inline HTML-tags gengives Markdown-syntaks (f.eks. **strong** , *emphasis* osv.) i HTML-tags på blokniveau ikke som i eksemplet nedenfor.
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.
Bedste praksis
Vi anbefaler at formatere HTML i Markdown-filer på følgende måder for at forhindre gengivelsesfejl på DevSite.
Brug ikke ikke-understøttede HTML-tags på blokniveau. DevSite understøtter mange HTML-tags på blokniveau; men at inkludere en ikke-understøttet vil enten gengive din HTML som tekst eller bryde koden.
Tilføj ikke ekstra tabulatorer eller mellemrum, når du indrykker Start- og sluttags på blokniveau bør ikke indrykkes med tabulatorer eller mellemrum. Nogle redaktører tilføjer automatisk ekstra faner eller mellemrum - pas på!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Glem ikke, at kode uden indrykning er relativ
For eksempel behøver du ikke indrykke start- og sluttags på blokniveau, når du opretter lister 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
Tilføj ikke en tom linje mellem et start- og sluttag
Dette er nemt at gøre, når du skifter mellem Markdown og HTML, men en simpel tom linje kan nemt gengive en side forkert.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.