Markdown és un format d'escriptura; HTML és un format de publicació. Per tant, la sintaxi de Markdown no pretén oferir tota la versatilitat de l'HTML, només els elements més comuns per al text escrit. Quan necessiteu fer alguna cosa més complicada, podeu utilitzar qualsevol etiqueta HTML en línia i etiquetes de nivell de bloc compatibles amb DevSite en un fitxer Markdown. No cal que indiqueu que esteu canviant de Markdown a HTML, només heu d'utilitzar l'etiqueta HTML com a l'exemple següent.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
HTML en línia
Les etiquetes HTML en línia es poden utilitzar dins d'un paràgraf, un element de llista o una capçalera de Markdown, i també poden contenir sintaxis de Markdown (p. ex., **strong** , *emphasis* , etc.) Això és útil quan voleu cridar l'atenció sobre una mica de codi, com a l'exemple següent.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML a nivell de bloc
Les etiquetes HTML de nivell de bloc que són compatibles amb DevSite s'han de separar del contingut circumdant amb una línia en blanc. I a diferència de les etiquetes HTML en línia, la sintaxi de Markdown (p. ex., **strong** , *emphasis* , etc.) a les etiquetes HTML a nivell de bloc no es representa com a l'exemple següent.
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.
Bones pràctiques
Recomanem formatar HTML als fitxers Markdown de les maneres següents per evitar errors de representació a DevSite.
No utilitzeu etiquetes HTML a nivell de bloc no compatibles DevSite admet moltes etiquetes HTML a nivell de bloc; però incloure-ne un que no sigui compatible representarà el vostre HTML com a text o trencarà el codi.
No afegiu pestanyes o espais addicionals en sagnar. Les etiquetes d'inici i final a nivell de bloc no s'han de sagnar amb tabulacions o espais. Alguns editors afegeixen automàticament pestanyes o espais addicionals: compte!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
No oblideu que el codi sense sagnat és relatiu
Per exemple, no cal que sagneu les etiquetes d'inici i final a nivell de bloc quan creeu llistes a 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
No afegiu una línia en blanc entre una etiqueta d'inici i una de finalització
Això és fàcil de fer quan canvieu entre Markdown i HTML, però una simple línia en blanc pot representar fàcilment una pàgina de manera incorrecta.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.