Markdown yra rašymo formatas; HTML yra leidybos formatas. Taigi Markdown sintaksė nėra skirta pasiūlyti visą HTML universalumą, o tik labiausiai paplitusius rašytinio teksto elementus. Kai reikia atlikti ką nors sudėtingesnio, Markdown faile galite naudoti bet kurią eilutę HTML ir bloko lygio žymas, kurias palaiko DevSite. Nereikia nurodyti, kad pereinate nuo žymėjimo prie HTML, tiesiog naudokite HTML žymą, kaip parodyta toliau pateiktame pavyzdyje.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Inline HTML
Įterptosios HTML žymos gali būti naudojamos Markdown pastraipoje, sąrašo elemente arba antraštėje, jose taip pat gali būti Markdown sintaksė (pvz., **strong** , *emphasis* ir kt.). Tai naudinga, kai norite atkreipti dėmesį į šiek tiek kodo, kaip parodyta toliau pateiktame pavyzdyje.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
Bloko lygio HTML
Bloko lygio HTML žymos, kurias palaiko DevSite, turi būti atskirtos nuo aplinkinio turinio tuščia eilute. Skirtingai nuo įterptųjų HTML žymų, „Markdown“ sintaksė (pvz., **strong** , *emphasis* ir tt) bloko lygio HTML žymose neteikiama taip, kaip nurodyta toliau pateiktame pavyzdyje.
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.
Geriausios praktikos
Rekomenduojame formatuoti HTML Markdown failuose šiais būdais, kad išvengtumėte pateikimo klaidų DevSite.
Nenaudokite nepalaikomų bloko lygio HTML žymų DevSite palaiko daug bloko lygio HTML žymų; bet įtraukus nepalaikomą, jūsų HTML bus pateiktas kaip tekstas arba sulaužys kodą.
Nepridėkite papildomų skirtukų ar tarpų, kai įtraukite bloko lygio pradžios ir pabaigos žymas, kurios neturėtų būti įtrauktos su tabuliatoriais ar tarpais. Kai kurie redaktoriai automatiškai prideda papildomų skirtukų ar tarpų – saugokitės!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Nepamirškite, kad kodas be įtraukos yra santykinis
Pavyzdžiui, jums nereikia įtraukti bloko lygio pradžios ir pabaigos žymų kuriant sąrašus 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
Nedėkite tuščios eilutės tarp pradžios ir pabaigos žymų
Tai lengva padaryti, kai perjungiate iš Markdown ir HTML, tačiau paprasta tuščia eilutė gali lengvai pavaizduoti puslapį neteisingai.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.