Markdown er et skriveformat; HTML er et publiseringsformat. Markdown-syntaks er derfor ikke ment å tilby den fulle allsidigheten til HTML, bare de vanligste elementene for skrevet tekst. Når du trenger å gjøre noe mer komplisert, kan du bruke en hvilken som helst innebygd HTML-tag og tagger på blokknivå som støttes av DevSite i en Markdown-fil. Det er ikke nødvendig å indikere at du bytter fra Markdown til HTML, bare bruk HTML-koden som i eksemplet nedenfor.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Inline HTML
Innebygde HTML-tagger kan brukes i et Markdown-avsnitt, listeelement eller overskrift, og de kan også inneholde Markdown-syntaks (f.eks. **strong** , *emphasis* , osv.) Dette er nyttig når du vil trekke oppmerksomhet til litt 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å blokknivå
HTML-tagger på blokknivå som støttes av DevSite, må skilles fra omkringliggende innhold med en tom linje. Og i motsetning til innebygde HTML-tagger, gjengis ikke Markdown-syntaks (f.eks. **strong** , *emphasis* , etc.) i HTML-tagger på blokknivå 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.
Beste praksis
Vi anbefaler å formatere HTML i Markdown-filer på følgende måter for å forhindre gjengivelsesfeil på DevSite.
Ikke bruk HTML-tagger på blokknivå som ikke støttes. DevSite støtter mange HTML-tagger på blokknivå; men å inkludere en ikke-støttet vil enten gjengi HTML-en din som tekst eller bryte koden.
Ikke legg til ekstra tabulatorer eller mellomrom ved innrykk Start- og sluttkoder på blokknivå skal ikke rykkes inn med tabulatorer eller mellomrom. Noen redaktører legger automatisk til ekstra faner eller mellomrom – pass 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.
Ikke glem at kode uten innrykk er relativ
Du trenger for eksempel ikke å rykke inn start- og sluttkoder på blokknivå når du oppretter 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
Ikke legg til en tom linje mellom en start- og slutttag
Dette er enkelt å gjøre når du bytter mellom Markdown og HTML, men en enkel tom linje kan lett gjengi en side feil.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.