Sintassi di base per Markdown

Panoramica

Nonostante alcune variazioni, la maggior parte delle applicazioni supporta gli elementi di base di Markdown. Questi elementi sono essenziali per poter formattare un documento. Ma non commettere errori, usando solo le basi di Markdown puoi creare siti ben progettati per Web.

NOTA: Quando possibile, quando ci sono variazioni di sintassi da un processore Markdown a un altro, queste saranno annotate nell'articolo.

Titoli

Ogni documento ha o dovrebbe avere un titolo, corretto? Quindi, iniziamo con esso.

Il simbolo utilizzato per formattare un titolo in Markdown è la parola tag #. Quando si crea il titolo, formattare il codice inserendo un cancelletto all'inizio della riga, demarcando l'intestazione.

Per esempio:

# Titolo di livello 1

Verrà convertito in tag h1 da HTML.

<h1>Titolo di livello 1</h1>.

NOTA: tag h1 rappresenta il titolo più importante di HTML, solitamente il titolo dell'articolo.

Il numero di hash che utilizzi all'inizio della riga indica il livello del titolo, pertanto la formattazione ### My title crea un'intestazione di livello 3.

NOTA: Quando parliamo di livello, parliamo dei titoli convertiti in HTML. In HTML i livelli del titolo vanno da 1 a 6, indicati con tags h1, h2, h3, h4, h5 e h6

ESEMPI

# Titolo di livello 1

<h1>Titolo di livello 1</h1>

## Titolo di livello 2

<h2>Titolo di livello 2</h2>

### Titolo di livello 3

<h3>Titolo di livello 3</h3>

#### Titolo di livello 4

<h4>Titolo di livello 4</h4>

##### Titolo di livello 5

<h5>Titolo di livello 5</h5>

###### Titolo di livello 6

<h6>Titolo di livello 6</h6>

Sintassi alternativa

Markdown offre una sintassi diversa per la costruzione di intestazioni di livello 1 e 2. Invece di utilizzare l'hash all'inizio della riga, aggiungi i segni di uguale == sotto le intestazioni di livello 1 e i segni meno - per il livello 2 intestazioni.

ESEMPI

Titolo di livello 1
===============

<h1>Titolo di livello 1</h1>

Titolo di livello 2
---------------

<h2>Titolo di livello 1</h2>

Alcuni editor di Markdown consentono di utilizzare solo un segno di uguale = o un trattino - sotto il testo, ma questo può causare problemi di formattazione in altri editor che non sono compatibili con questa sintassi.

Titoli: buone pratiche

Potresti incontrare problemi di compatibilità quando parliamo dello spazio tra il cancelletto # all'inizio della riga e il testo del titolo.

Si consiglia di aggiungere sempre almeno uno spazio tra di loro, oltre a fornire una migliore lettura del documento, avrai ancora più supporto per la modifica tra le applicazioni Markdown.

Tabella 1.3 esemplifica la corretta costruzione del titolo.

Paragrafi

La formattazione più semplice per Markdown è quella del paragrafo. Per crearne uno, separa semplicemente una parte di testo con una riga vuota, creando frammentazioni che il processore Markdown interpreterà come paragrafi.

ESEMPI

Markdown è importante per ogni programmatore.

Imparare Markdown è essenziale per una carriera di successo.

<p>Markdown è importante per ogni programmatore.</p>

<p>Imparare Markdown è essenziale per una carriera di successo.<p>

Paragrafi: migliori pratiche

Di solito il paragrafo è bloccato all'inizio della riga, cioè evita di farlo rientrare utilizzando spazi di qualsiasi tipo, né spazi né tabulazioni.

NOTA: il paragrafo deve essere rientrato quando si trova all'interno di un elenco.

Tabella 1.5 esemplifica l'uso corretto per la costruzione di un paragrafo.

Interruzioni di riga

In HTML un'interruzione di riga è rappresentata da tag br.

Per generare un'interruzione di riga in Markdown, inserire due o più spazi alla fine della riga e premere il tasto Enter.

ESEMPI

Prima riga del documento.
Seconda riga del documento.

<p>Prima riga del documento.<br>

Seconda riga del documento.</p>

Interruzione di riga: best practice

L'uso di spazi bianchi per creare interruzioni di riga, sebbene compatibile con la maggior parte delle applicazioni, può causare problemi di formattazione.

Ecco alcuni punti:

• Gli spazi vuoti dopo la riga sono difficili da notare.
• Le persone possono aggiungere spazi vuoti alla fine della riga, a causa dell'abitudine o della disattenzione.
• Alcuni editor di testo, come Sublime Text, hanno impostazioni che rimuovono gli spazi bianchi, prima e dopo, dalla riga durante il salvataggio del documento.

Uma alternativa viável para evitar qualquer problema com quebra de linhas, basta usar a tag HTML <br> diretamente nos seus documentos.

NOTA: è interessante ricordare che la maggior parte delle applicazioni Markdown sono compatibili anche con tags in HTML, cioè puoi unire la formattazione Markdown con la formattazione HTML nello stesso documento.

NOTA: in alcune applicazioni, è sufficiente premere il tasto Enter per creare un'interruzione di riga

NOTA: le variazioni di Markdown, come CommonMark, interpretano l'uso di una barra rovesciata \ come un indicatore di una nuova riga.

La pressione del tasto Enter o l'uso della barra rovesciata \, sebbene validi, non sono raccomandati in quanto la compatibilità dipende dal programma Markdown.

Tabella 1.7 mostra la sintassi corretta per la creazione di una nuova riga.

Enfasi

Simile a un editor WYSIWYG, come Microsoft Word, Markdown offre anche la formattazione per enfatizzare il testo.

Tra i formati di enfasi più popolari ci sono il grassetto e il corsivo, che possono essere applicati anche utilizzando la sintassi Markdown.

Grassetto in Markdown

Per formattare il testo in grassetto in Markdown, inserire due asterischi ** prima del contenuto e due asterischi ** dopo il contenuto.

ESEMPI

**This part of the text** will be bold.

<strong>This part of the text</strong> will be bold.

__This part of the text__ will be bold.

<strong>This part of the text</strong> will be bold.

Markdown**Is**Easy**To**Learn

Markdown<strong>Is</strong>Easy<strong>To</strong>Learn

NOTA: come mostrato negli esempi precedenti, è possibile sostituire gli asterischi con trattini bassi, utilizzando due trattini bassi __ prima e dopo il contenuto formatta anche il testo in grassetto in Markdown.

Grassetto: migliori pratiche

Sia l'uso di due asterischi che l'uso di due trattini bassi possono applicare la formattazione in grassetto al contenuto.

Tuttavia, l'uso di trattini bassi nel mezzo di una parola può generare problemi di formattazione a seconda del processore Markdown, quindi preferibilmente nell'uso degli asterischi.

Tabella 1.9 mostra l'uso consigliato per la formattazione in grassetto.

Corsivo in Markdown

Simile al grassetto, la formattazione corsivo in Markdown utilizza anche un asterisco * o un trattino basso _, ma in caso di corsivo, usa solo un asterisco * prima del contenuto e un asterisco * dopo il contenuto.

ESEMPI

*This part of the text* will be in italics.

<em>This part of the text</em> will be in italics.

_This part of the text_ will be in italics.

<em>This part of the text</em> will be in italics.

Markdown*Is*Easy*To*Learn

Markdown<em>Is</em>Easy<em>To</em>Learn

Per scrivere in corsivo la metà di una parola in Markdown, usa un asterisco prima e dopo il contenuto.

Esempio:

Mar*kdo*wn

Corsivo: buone pratiche

Usa sempre un asterisco * quando usi il corsivo nel mezzo di una parola, questo eviterà problemi di compatibilità con i processori Markdown.

Tabella 1.11 mostra il markup consigliato per enfatizzare il contenuto in corsivo.

Grassetto e corsivo

Solo grassetto o solo corsivo? Se lo desideri, puoi combinare i due formati per evidenziare qualsiasi contenuto.

Per applicare il grassetto e il corsivo contemporaneamente, aggiungi tre asterischi *** o tre trattini bassi ___ intorno al testo da evidenziare.

Se intendi enfatizzare la parte centrale di una parola con entrambi i formati, dai la preferenza all'uso degli asterischi, in questo caso tre asterischi ***.

ESEMPI

***This part of the text*** will be bold and italicized.

<strong><em>This part of the text</em></strong> will be bold and italicized.

This is really ___important___.

This is really <strong><em>important</em></strong>.

This is really __*important*__.

This is really <strong><em>important</em></strong>.

This is really **_important_**.

This is really <strong><em>important</em></strong>.

This text is ***really*** important.

This text is <strong><em>really</em></strong> important.

Grassetto e corsivo: best practice

Per evitare problemi di compatibilità con le applicazioni Markdown, quando si evidenzia la metà di una parola, combinando grassetto e corsivo, dare la preferenza all'uso di tre asterischi.

Tabella 1.13 dimostra l'uso indicato per combinare entrambi i formati.

Blockquote

Para marcar um conteúdo como blockquote no Markdown, use o sinal de maior que > no começo do parágrafo.

Ad esempio, questo tag Markdown:

> Contenuto Blockquote.

Questo output risulterebbe in HTML:

Contenuto Blockquote.

Blockquote con più paragrafi

Se você precisa de um blockquote contendo diversos parágrafos dentro dele, utilize o sinal de maior que > a frente de cada um desses parágrafos e os separe por uma linha contendo apenas o sinal de maior que.

NOTA: Il segno maggiore di > deve essere posizionato sulla riga che separa i paragrafi in modo che il processore Markdown possa interpretare correttamente il suo markup.

Diamo un'occhiata a un esempio:

> Primo paragrafo della citazione.
>
> Secondo paragrafo del blockquote.

L'output in HTML:

Primo paragrafo della citazione.

Secondo paragrafo del blockquote.

Blockquotes annidato

Oltre ad inserire più paragrafi all'interno di un blockquote, puoi anche nidificarli, cioè inserendo blockquotes all'interno di blockquotes, complex? Semplifichiamo.

Per creare un blocco nidificato, utilizzare due segni di maggiore di >> prima del paragrafo.

Esempio:

> Contenuto Blockquote.
>
>> Questo paragrafo verrà interpretato come un blockquote annidato.

Rendering in HTML:

Contenuto Blockquote.

Questo paragrafo verrà interpretato come un blockquote annidato.

Blockquote con altri elementi

La versatilità del blockquotes permette l'inserimento di altri elementi Markdown al loro interno.

NOTA: alcuni elementi Markdown potrebbero non essere visualizzati correttamente quando inseriti in un blockquote, questo varia molto tra i processori Markdown.

> #### Titolo h4 all'interno del blocco
>
> - Primo elemento della lista all'interno del blockquote.
> - Secondo elemento della lista all'interno del blockquote.
>
>  *Testo in corsivo* parte del paragrafo senza formattazione **testo grassetto**.

L'output in HTML:

Titolo h4 all'interno del blocco

• Primo elemento della lista all'interno del blockquote.
• Secondo elemento della lista all'interno del blockquote.

Parte di testo in corsivo del paragrafo senza formattazione testo in grassetto.

Liste

Gli elenchi sono essenziali per organizzare gli argomenti all'interno del documento. Un elenco facilita la visualizzazione di elementi che possono essere correlati tra loro.

Per creare una lista in Markdown usiamo numeri per liste ordinate, cioè in sequenza e trattini -, o segni più +, o asterischi * per liste non ordinate.

Elenchi ordinati

Cominciamo ordinando gli elementi della nostra lista, per questo mettiamo un numero seguito da un punto e il testo dell'elemento.

Vale la pena notare che i numeri degli elementi non devono essere in ordine numerico crescente, tuttavia, il primo elemento nell'elenco deve iniziare con il numero uno 1.

NOTA: per creare un elemento rientrato, inserire una tabulazione prima del numero che contrassegna l'elemento. In alcuni processori Markdown è possibile inserire anche 3 spazi prima della numerazione, il risultato è simile, tuttavia questo può variare a seconda dell'applicazione, in caso di dubbio utilizzare TAB.

ESEMPI

1. Primo elemento
2. Secondo elemento
3. Terzo elemento
4. Quarto elemento

<ol>
    <li>Primo elemento</li>
    <li>Secondo elemento</li>
    <li>Terzo elemento</li>
    <li>Quarto elemento</li>
</ol>

1. Primo elemento
1. Secondo elemento
1. Terzo elemento
1. Quarto elemento

<ol>
    <li>Primo elemento</li>
    <li>Secondo elemento</li>
    <li>Terzo elemento</li>
    <li>Quarto elemento</li>
</ol>

1. Primo elemento
8. Secondo elemento
3. Terzo elemento
5. Quarto elemento

<ol>
    <li>Primo elemento</li>
    <li>Secondo elemento</li>
    <li>Terzo elemento</li>
    <li>Quarto elemento</li>
</ol>

1. Primo elemento
2. Secondo elemento
3. Terzo elemento
    1. Elemento rientrato
    2. Elemento rientrato
4. Quarto elemento

<ol>
    <li>Primo elemento</li>
    <li>Secondo elemento</li>
    <li>Terzo elemento</li>
    <ol>
        <li>Elemento rientrato</li>
        <li>Elemento rientrato</li>
    </ol>
    </li>
    <li>Quarto elemento</li>
</ol>

Elenchi non ordinati

Una lista non ordinata è una sequenza di elementi denotata, di solito da qualche simbolo a sinistra dell'elemento, cioè non c'è una sequenza numerica qui.

Il markup per Markdown per creare elenchi non ordinati è il segno più +, o il trattino - o l'asterisco *.

Posiziona uno di questi due segni prima della voce dell'elenco per delimitarla, seguito da uno spazio vuoto e dal contenuto dell'elemento.

NOTA: fa rientrare un elemento nell'elenco inserendo una tabulazione prima che l'elemento sia contrassegnato.

ESEMPI

- Primo elemento
- Secondo elemento
- Terzo elemento
- Quarto elemento

<ul>
    <li>Primo elemento</li>
    <li>Secondo elemento</li>
    <li>Terzo elemento</li>
    <li>Quarto elemento</li>
</ul>

* Primo elemento
* Secondo elemento
* Terzo elemento
* Quarto elemento

<ul>

    <li>Primo elemento</li>

    <li>Secondo elemento</li>

    <li>Terzo elemento</li>

    <li>Quarto elemento</li>

</ul>

+ Primo elemento
* Secondo elemento
- Terzo elemento
+ Quarto elemento

<ul>

    <li>Primo elemento</li>

    <li>Secondo elemento</li>

    <li>Terzo elemento</li>

    <li>Quarto elemento</li>

</ul>

- Primo elemento
- Secondo elemento
- Terzo elemento
    - Elemento rientrato
    - Elemento rientrato
- Quarto elemento

<ul>
    <li>Primo elemento</li>
    <li>Secondo elemento</li>
    <li>Terzo elemento
    <ul>
        <li>Elemento rientrato</li>
        <li>Elemento rientrato</li>
    </ul>
    </li>
    <li>Quarto elemento</li>
</ul>

Aggiunta di elementi

Markdown ti permette di inserire altri elementi nel mezzo di una lista senza interromperne la continuità.

Per preservare la formattazione dell'elenco, rientra il diverso elemento di 4 spazi o di una tabulazione.

Paragrafi

* Questo è il primo elemento della lista.
* Questo è il secondo elemento della lista.
    Un paragrafo aggiunto senza interrompere la stringa dell'elenco.
* E infine il terzo elemento della lista.

Il risultato sarebbe questo:

• Questo è il primo elemento della lista.
• Questo è il secondo elemento della lista.

• Un paragrafo aggiunto senza interrompere la stringa dell'elenco.

• E infine il terzo elemento della lista.

Blockquote nell'elenco

* Questo è il primo elemento della lista.
* Questo è il secondo elemento della lista.

    > Blockquote al centro dell'elenco.

* E infine il terzo elemento della lista.

Il risultato sarebbe simile a questo:

• Questo è il primo elemento della lista.

• Questo è il secondo elemento della lista.

  Blockquote al centro dell'elenco.

• Ed ecco il terzo elemento della lista.

Blocco di codice

Quando si inserisce un blocco di codice all'interno di un elenco, rientra di otto spazi o due tabulazioni.

Di seguito è riportato un esempio di un elenco con un blocco di codice al suo interno.

1. Per prima cosa apriamo il nostro file index.html.
2. Individua il blocco di codice mostrato di seguito:

        <html>
            <head>
            <title>Il titolo del mio sito web</title>
        </head>

3. Cambia il titolo della pagina.

Il risultato è simile a questo:

1. Per prima cosa apriamo il nostro file index.html.

2. Individua il blocco di codice mostrato di seguito:

   <html>
       <head>
       <title>Il titolo del mio sito web</title>
   </head>

3. Cambia il titolo della pagina.

Si noti che la sequenza numerica della lista non è cambiata nemmeno con l'inserimento del blocco di codice tra gli elementi.

immagini

1. Per prima cosa apri il file del logo Markdown.
2. Vedere il logo Markdown sullo schermo.

    ![Logo Markdown](https://markdown.net.br/assets/img/basic-syntax/markdown-logo-small.png)

3. Ora puoi chiudere il file.

Il rendering in HTML sarebbe simile a questo:

1. Per prima cosa apri il file del logo Markdown.

2. Vedere il logo Markdown sullo schermo.

   
3. Ora puoi chiudere il file.

Codice

Usando Markdown possiamo demarcare una parte del contenuto come codice usando le virgolette `. Metti un backquote prima e dopo il testo che verrà interpretato dal processore Markdown come codice.

ESEMPIO:

`codice`.

<code>codice.</code>

Fuga dalla spina dorsale

È possibile che si verifichi la seguente situazione.

Il contenuto a cui si intende applicare la formattazione del codice contiene già una citazione a ritroso. O se vuoi usare la virgoletta all'indietro per evidenziare parte del testo all'interno del codice stesso.

Per tradurre, è necessario inserire una citazione all'interno di una demarcazione del codice senza che questa citazione venga interpretata come markup Markdown.

La soluzione è semplice, duplica il retro iniziale e finale che circondano il pezzo di codice.

ESEMPI

``Utilizzo di "crase" nel markup del codice.``

<code>Utilizzo di "crase" nel markup del codice.</code>

Blocco di codice

Markdown ci permette di creare blocchi di codice indentando 4 spazi o una tabulazione.

Vedi il seguente esempio:

    <html>
        <head>
        </head>
    </html>

Il risultato:

<html>
    <head>
    </head>
</html>

Usando la sintassi estesa di Markdown possiamo creare blocchi di codice senza indentare spazi, per questo dobbiamo usare il tag circondato da blocchi di codice.

Linee orizzontali

Tre asterischi di seguito *** o tre trattini --- o tre trattini bassi ___ creano una linea orizzontale.

Una riga deve contenere solo quei caratteri affinché il processore Markdown interpreti correttamente la linea orizzontale.

***

---

_________________

Usando uno qualsiasi dei caratteri il risultato sarà lo stesso, vedi sotto.

NOTA: Non è necessario stabilire un numero massimo di caratteri per creare una riga, purché ne usi almeno 3 e la riga ha solo questi caratteri, puoi inserirne quanti ne vuoi.

Linee orizzontali: buone pratiche

Aggiungere sempre una riga vuota prima e dopo il segno di linea orizzontale. Ciò è necessario a causa della sintassi alternativa per la creazione dei titoli, se metti tre trattini --- direttamente sotto una riga con il contenuto, questo verrà interpretato come un titolo di livello 2.

Tabella 1.18 esemplifica la creazione di linee orizzontali nel modo corretto.

Links

Links vengono utilizzati per creare collegamenti tra parti del documento. Quando si tratta di creare una pagina per Web o anche file PDF, essere in grado di inserire links è una delle caratteristiche indispensabili per modificare questi tipi di documenti.

La sintassi di base per creare links in Markdown è la seguente:

• Metti il ​​testo che rappresenterà link tra parentesi quadre, esempio:
  [Il miglior sito Markdown al mondo].
• Quindi, l'indirizzo di link, noto anche come URL, deve essere racchiuso tra parentesi, esempio:
  (https://markdown.net.br)

Mettere tutto insieme.

Visitare [Il miglior sito Markdown al mondo](https://markdown.net.br).

E l'output su HTML.

Visita Il miglior sito Markdown al mondo

Aggiunta di titoli

Se hai un po 'di esperienza con HTML, sai che quando l'utente posiziona mouse su link nella pagina, di solito viene presentata all'utente una piccola etichetta che descrive lo scopo di link.

Questa etichetta è il titolo di link e per crearla usando Markdown basta aggiungere tra parentesi un testo tra virgolette dopo URL.

Esempio:

Visitare [Il miglior sito Markdown al mondo](https://markdown.net.br "Il riferimento definitivo per Markdown.").

Esci in HTML, posiziona mouse sullo link e guarda apparire il titolo.

Visitare Il miglior sito Markdown al mondo

indirizzi URLs e email

Você também pode transformar uma URL em link automaticamente colocando-a entre os sinais de menor que < e maior que >.

<https://markdown.net.br>
<email@host.com>

Il risultato è simile a questo:

https://markdown.net.br
email@host.com

Sottolineando links

Aggiungendo asterischi attorno al formato link, cioè prima delle parentesi e dopo le parentesi, si indica al processore Markdown che quello link dovrebbe essere enfatizzato.

Per esempio:

Visita il sito web: *[Riferimento Markdown](https://markdown.net.br)*.
Raccomando il motore di ricerca: **[Duck Duck GO](https://duckduckgo.com/)**.

L'output in HTML sarebbe simile a questo:

Visita il sito web: Riferimento Markdown
Consiglio il motore di ricerca: Duck Duck GO.

Puoi anche evidenziare un link utilizzando la formattazione del codice.

Esempio:

Rivedi la sezione: [`codice`](#code).

Risultato:

Rivedi la sezione: codice

stile di riferimento Links

Markdown offre una sintassi alternativa per la creazione di links che consente una visualizzazione più pulita del documento.

Con questa sintassi puoi posizionare il testo che verrà trasformato in link al centro del paragrafo con un solo riferimento, alla fine del documento aggiungi tutti i links usando gli stessi riferimenti di prima.

NOTA: puoi inserire il riferimento link ovunque nel tuo documento, lo consiglio alla fine per motivi di organizzazione.

Poiché la creazione di questo riferimento link è divisa in due parti, analizzeremo ciascuna di esse.

Prima parte di link

Per prima cosa creeremo due serie di parentesi quadre, all'interno del primo posto il testo di link, cioè il testo che apparirà sulla pagina, in secondo luogo un'etichetta che servirà da riferimento per l'indirizzo di link:

[Markdown - Wikipedia][1]

NOTA: L'etichetta del riferimento link, situata all'interno della seconda coppia di parentesi quadre, può essere qualsiasi cosa, numeri, parole, frasi, può anche includere la punteggiatura, dipende da te, purché il riferimento a lo link alla fine del documento è lo stesso.

Esempi:

[Markdown - Wikipedia][wiki_markdown.1]
[Sito ufficiale di John Gruber][JOHN GRUBER]

NOTA: Anche l'etichetta di riferimento non fa distinzione tra maiuscole e minuscole, ad esempio wiki_markdown è uguale a WIKI_MARKDOWN.

Seconda parte di link

La seconda parte indica dove punta quel link, cioè il URL di link.

Per assemblare la seconda parte di link dobbiamo avere quanto segue:

1. Un'etichetta di riferimento link valida creata in precedenza nel documento, racchiuderla tra parentesi quadre, seguita da due punti e almeno uno spazio vuoto (ad esempio, [etichetta]:).
2. O endereço do link, opcionalmente essa URL pode estar entre os sinais de menor que < e maior que >.
3. Il titolo dello link tra virgolette "", virgolette singole '' o parentesi (), ovviamente, il titolo è facoltativo.

Tutti gli esempi seguenti sono validi per la formattazione della seconda parte:

[1]: https://en.wikipedia.org/wiki/Markdown
[1]: https://en.wikipedia.org/wiki/Markdown "Markdown - Wikipedia"
[1]: https://en.wikipedia.org/wiki/Markdown 'Markdown - Wikipedia'
[1]: https://en.wikipedia.org/wiki/Markdown (Markdown - Wikipedia)
[1]: <https://en.wikipedia.org/wiki/Markdown> "Markdown - Wikipedia"
[1]: <https://en.wikipedia.org/wiki/Markdown> 'Markdown - Wikipedia'
[1]: <https://en.wikipedia.org/wiki/Markdown> (Markdown - Wikipedia)

Sottolineo di nuovo che puoi inserire questa seconda parte di link ovunque nel tuo documento, la aggiungo alla fine del file per motivi di organizzazione

Mettere insieme tutti i pezzi

Qui ti presenterò una situazione in cui l'uso del riferimento links può rendere il tuo documento Markdown più facile da leggere.

Supponiamo che sia necessario aggiungere uno o più links a un sito Web con ulteriori informazioni sul contenuto trattato in quel paragrafo.

In Markdown sarebbe simile a questo:

Per saperne di più puoi consultare questo articolo di Markdown: [Wikipedia](https://en.wikipedia.org/wiki/Markdown "Markdown - Wikipedia"). O la documentazione in lingua: [John Gruber](https://daringfireball.net/projects/markdown/ "Documentazione originale per Markdown.").

Nota che l'aggiunta di links all'interno del paragrafo stesso può rendere il testo più difficile da leggere, specialmente se la persona che lo legge non conosce Markdown.

Poiché links sono importanti per il contesto del paragrafo, non possiamo rimuoverli, tuttavia esiste un modo più efficace per ripulire quel paragrafo utilizzando il riferimento links.

Per saperne di più puoi consultare questo articolo di Markdown: [Wikipedia][1]. O la documentazione in lingua: [John Gruber][2].

[1]: <https://en.wikipedia.org/wiki/Markdown> "Markdown - Wikipedia"
[2]: https://daringfireball.net/projects/markdown/ "Documentazione originale per Markdown."

NOTA: A colocação do sinal de menor que < e de maior que > ao redor do link é opcional.

I due formati sopra avranno risultati idênticos in HTML:

Per saperne di più puoi consultare questo articolo di Markdown: Wikipedia. O la documentazione in lingua: John Gruber.

riferimento Links: best practice

In alcuni casi, potresti incontrare spazi vuoti in URLs, questo può diventare un problema a seconda dell'applicazione Markdown.

Per evitare anomalie di formattazione, utilizza lo spazio bianco codificato: %20.

Tabella 1.19 presenta la formattazione dello spazio bianco in URL utilizzando la codifica.

immagini

La sintassi per Markdown per aggiungere un'immagine è la seguente:

1. Un punto esclamativo: !.
2. Il testo alternativo dell'immagine tra parentesi quadre: []
3. L'indirizzo completo dell'immagine tra parentesi: ()
4. Titolo facoltativo tra virgolette, ancora tra parentesi: ( "")

Esempio:

![Markdown è il linguaggio di markup più semplice al mondo!](https://markdown.net.br/assets/img/markdown.jpg "Logo Markdown")

La conversione in HTML è simile a questa:

Immagine e Link

Per utilizzare un'immagine come link:

1. Crea un normale formato link.
2. Nella prima coppia di parentesi nel formato link, che fa riferimento al tuo testo, usa il formato immagine Markdown che hai imparato appena sopra.

Esempio:

[![Un'antica pietra nel deserto](https://markdown.net.br/assets/img/shiprock.jpg "Shiprock, New Mexico By Beau Rogers")](https://www.flickr.com/photos/beaurogers/31833779864/in/photolist-Qv3rFw-34mt9F-a9Cmfy-5Ha3Zi-9msKdv-o3hgjr-hWpUte-4WMsJ1-KUQ8N-deshUb-vssBD-6CQci6-8AFCiD-zsJWT-nNfsgB-dPDwZJ-bn9JGn-5HtSXY-6CUhAL-a4UTXB-ugPum-KUPSo-fBLNm-6CUmpy-4WMsc9-8a7D3T-83KJev-6CQ2bK-nNusHJ-a78rQH-nw3NvT-7aq2qf-8wwBso-3nNceh-ugSKP-4mh4kh-bbeeqH-a7biME-q3PtTf-brFpgb-cg38zw-bXMZc-nJPELD-f58Lmo-bXMYG-bz8AAi-bxNtNT-bXMYi-bXMY6-bXMYv)

Il risultato:

Caratteri in fuga

Per eseguire l'escape di un carattere in Markdown, ovvero per rappresentarlo letteralmente nel documento, inserire una barra rovesciata prima di esso.

Esempio:

\* La barra rovesciata prima dell'asterisco fa sì che il processore Markdown interpreti quella riga come un paragrafo e non come un elemento di un elenco.

Il risultato è simile a questo:

* La barra rovesciata prima dell'asterisco fa sì che il processore Markdown interpreti questa riga come un paragrafo e non come un elemento di un elenco.

Personaggi a cui puoi sfuggire

Tabella 1.20 mostra quali caratteri è possibile eseguire l'escape in Markdown utilizzando la barra rovesciata: \.

HTML e Markdown

I programmatori che hanno già esperienza in HTML, a volte mescolano le due sintassi nello stesso documento, cioè HTML e Markdown.

HTML può essere utile in attività come la modifica degli attributi di elementi del documento come colori, posizione, dimensione e così via.

Posiziona tags HTML direttamente sul tuo documento.

**grassetto** <em>Corsivo</em>

Il risultato è simile a questo:

grassetto itálico

HTML e Markdown: best practice

È importante notare che non tutti i processori Markdown sono compatibili con tags HTML, in alcuni casi supportano solo un sottoinsieme di questi tags.

Prova ed errore possono essere una strategia. Prova a formattare il contenuto usando tags e controlla se l'output in HTML è come previsto o, naturalmente, consulta la documentazione dell'applicazione.

Non indentare la riga di tags in HTML, né con gli spazi né con le tabulazioni, questo può interferire con la formattazione dell'elemento quando convertito.

Inserire una riga vuota prima e dopo gli elementi del blocco, esempio: <div>, <table>, <pre>, <p>.

Evita di posizionare elementi Markdown all'interno del contenuto di tags HTML.

Il codice seguente, sebbene funzioni in alcuni editor, ha una combinazione di sintassi che può causare problemi di formattazione.

<p>Corsivo **grassetto**</p>