Markdown on kirjoitusmuoto; HTML on julkaisumuoto. Markdown-syntaksin ei siis ole tarkoitus tarjota HTML:n täyttä monipuolisuutta, vaan vain yleisimpiä kirjoitetun tekstin elementtejä. Kun sinun on tehtävä jotain monimutkaisempaa, voit käyttää mitä tahansa upotettua HTML-tunnistetta ja lohkotason tageja, joita DevSite tukee Markdown-tiedostossa. Sinun ei tarvitse ilmoittaa, että olet siirtymässä Markdownista HTML:ään, käytä vain HTML-tunnistetta alla olevan esimerkin mukaisesti.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Sisäänrakennettu HTML
Sisäisiä HTML-tageja voidaan käyttää Markdown-kappaleessa, luettelokohdassa tai otsikossa, ja ne voivat sisältää myös Markdown-syntaksin (esim. **strong** , *emphasis* jne.) Tästä on hyötyä, kun haluat kiinnittää huomion hieman koodia, kuten alla olevassa esimerkissä.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
Lohkotason HTML
DevSiten tukemat lohkotason HTML-tunnisteet on erotettava ympäröivästä sisällöstä tyhjällä rivillä. Ja toisin kuin upotetut HTML-tunnisteet, Markdown-syntaksia (esim. **strong** , *emphasis* jne.) lohkotason HTML-tageissa ei hahmonneta kuten alla olevassa esimerkissä.
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.
Parhaat käytännöt
Suosittelemme HTML-koodin muotoilua Markdown-tiedostoissa seuraavilla tavoilla estääksesi hahmonnusvirheet DevSitessa.
Älä käytä tukemattomia lohkotason HTML-tageja. DevSite tukee monia lohkotason HTML-tageja. mutta ei-tuetun lisääminen joko tekee HTML-koodisi tekstinä tai rikkoo koodin.
Älä lisää ylimääräisiä sarkaimia tai välilyöntejä sisennettäessä Lohkotason alku- ja lopputunnisteita ei saa sisentää sarkaimilla tai välilyönneillä. Jotkut editorit lisäävät automaattisesti ylimääräisiä sarkaimia tai välilyöntejä – varo!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Älä unohda, että sisennyttämätön koodi on suhteellista
Sinun ei esimerkiksi tarvitse sisentää lohkotason alku- ja lopputunnisteita luodessasi luetteloita Markdownissa.
* 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ä lisää tyhjää riviä aloitus- ja lopputunnisteen väliin
Tämä on helppo tehdä, kun vaihdat Markdownin ja HTML:n välillä, mutta yksinkertainen tyhjä rivi voi helposti hahmontaa sivun väärin.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.