Markdown è un formato di scrittura; HTML è un formato di pubblicazione. Pertanto, la sintassi Markdown non intende offrire la massima versatilità del codice HTML, ma solo gli elementi più comuni per il testo scritto. Quando devi svolgere operazioni più complesse, puoi utilizzare in un file Markdown qualsiasi tag HTML incorporato e tag a livello di blocco supportati da DevSite. Non è necessario indicare che stai passando da Markdown a HTML: è sufficiente utilizzare il tag HTML come nell'esempio riportato di seguito.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
HTML incorporato
I tag HTML in linea possono essere utilizzati all'interno di un paragrafo, di un elemento di elenco o di un'intestazione Markdown e possono contenere anche la sintassi Markdown (ad es. **strong**, *emphasis* e così via) Ciò è utile per attirare l'attenzione su una porzione di codice, come nell'esempio riportato di seguito.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML a livello di blocco
I tag HTML a livello di blocco supportati da DevSite devono essere separati dai contenuti circostanti con una riga vuota. Diversamente dai tag HTML in linea, la sintassi Markdown (ad es. **strong**, *emphasis* e così via) nei tag HTML a livello di blocco non vengono visualizzati come nell'esempio riportato di seguito.
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.
Best practice
Consigliamo di formattare l'HTML nei file Markdown nei seguenti modi per evitare errori di rendering su DevSite.
Non utilizzare tag HTML a livello di blocco non supportati DevSite supporta molti tag HTML a livello di blocco; ma l'inclusione di un codice non supportato comporta il rendering del codice HTML come testo oppure l'interruzione del codice.
Non aggiungere tabulazioni o spazi extra durante il rientro I tag di inizio e fine a livello di blocco non devono essere rientrati con tabulazioni o spazi. Alcuni editor aggiungono automaticamente schede o spazi extra. Attenzione!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Non dimenticare che il codice senza rientro è relativo
Ad esempio, non è necessario applicare il rientro ai tag di inizio e fine a livello di blocco quando crei elenchi in 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
Non aggiungere una riga vuota tra un tag di inizio e di fine
È facile farlo quando passi da Markdown a HTML e viceversa, ma una semplice riga vuota può facilmente rendere una pagina errata.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.