Come andare a capo in Markdown:due spazi, una barra rovesciata o un tag br.

Perché Markdown ignora il tuo a capo

Markdown unisce le righe di un paragrafo. Se scrivi

Roses are red
Violets are blue

chi legge vede un solo paragrafo, Le rose sono rosse Le viole sono blu. L'a capo nel sorgente è un'interruzione morbida: un punto in cui hai spezzato il testo, non dove chi legge deve vedere un'interruzione. Ti permette di spezzare le righe lunghe nell'editor senza cambiare l'aspetto della pagina.

Una riga vuota è diversa. Chiude il paragrafo e ne inizia uno nuovo, con spazio tra i due. Nella maggior parte dei casi è l'interruzione che vuoi.

Tre modi per forzare un a capo

Un a capo forzato, detto interruzione rigida, mantiene il testo nello stesso paragrafo e inizia la riga successiva.

1. Due spazi alla fine della riga

   Scrivi almeno due spazi prima di premere Invio. Funziona ovunque, ma gli spazi non si vedono e alcuni editor e impostazioni di Git li eliminano.

2. Una barra rovesciata alla fine della riga

   Metti \ come ultimo carattere, senza spazio dopo. È visibile e sopravvive alla rimozione degli spazi. Fa parte di CommonMark e di GitHub Flavored Markdown, anche se alcune app più vecchie non la conoscono.

3. Un tag HTML br

   Termina la riga con <br> (oppure <br/>). Funziona in quasi tutte le app che accettano HTML in linea. È anche l'unico modo per andare a capo dentro una cella di tabella.

Two spaces after this line  
comes out on a new line.

A backslash ends this one\
and breaks it too.

A tag also works.<br>
Third line.

Tutti e tre danno lo stesso risultato:

Due spazi dopo questa riga
vanno a capo.

Quale usare?

• Un nuovo paragrafo (riga vuota) per tutto ciò che è un pensiero separato. È la scelta più portabile.
• Una barra rovesciata quando ti serve un'interruzione a metà paragrafo, come in un indirizzo o in una poesia, e l'app segue CommonMark.
• Un tag br in una cella di tabella, o quando non sei sicuro che l'app supporti gli altri due.
• Due spazi solo quando sei certo che nulla li eliminerà.

Le interruzioni non funzionano dentro un frammento di codice, e un'interruzione alla fine di un paragrafo non fa nulla. Se vuoi dello spazio vuoto, usa una riga vuota o un titolo, non una pila di tag <br>.

Esempi: un indirizzo, una poesia, una voce di elenco

Un'interruzione rigida va bene per il testo in cui conta la riga stessa, come un indirizzo postale:

Jane Smith221B Baker StreetLondon

Mario Rossi
Via Garibaldi 12
20121 Milano

Dentro una voce di elenco, termina la riga con l'interruzione e rientra la riga successiva in modo che sia allineata al testo della voce:

- Pack the bags  and lock the door
- Leave at eight

Se ogni riga di un testo lungo ha bisogno di un'interruzione, il testo è probabilmente un elenco o un blocco di codice, e Markdown ha la sintassi per entrambi.

Quando l'a capo continua a non funzionare

• Un solo spazio finale. Ne servono due o più.
• Uno spazio dopo la barra rovesciata. La barra rovesciata deve essere l'ultimo carattere della riga.
• L'editor elimina gli spazi finali al salvataggio. Passa a una barra rovesciata o a un tag br.
• Lo stesso testo appare diverso in due posti. Alcune app, come le caselle di issue e commenti di GitHub, mantengono i singoli a capo come interruzioni, mentre un file Markdown su GitHub no. Un'interruzione forzata appare uguale in entrambi.
• Testo dentro una voce di elenco o una citazione. Tieni l'interruzione alla fine della riga, poi rientra la riga successiva in linea con la voce.

Il controllo più rapido è aprire il file in un lettore. DotMD segue queste regole: un singolo a capo unisce le righe, mentre due spazi, una barra rovesciata o un <br> spezzano la riga. La lettura è gratuita, e in DotMD Editor l'anteprima live mostra il risultato mentre scrivi.

Domande sugli a capo in Markdown

Altre domande