A capo in Markdown: nuove righe, paragrafi e celle di tabella

Per iniziare una nuova riga all'interno di un paragrafo Markdown, inserisci una barra inversa alla fine della prima riga, quindi premi Invio. Per iniziare un altro paragrafo, lascia una riga vuota. Queste operazioni producono strutture diverse nel documento, un aspetto importante quando esporti successivamente un README, un indirizzo o una relazione in Word.

Team della documentazione\
Via Esempio 42\
Portland, Oregon

L'indirizzo rimane in un unico paragrafo visualizzato su tre righe. Incollalo nell'anteprima Markdown per confrontarlo con gli esempi seguenti.

Scegli il tipo di interruzione necessario

Un'interruzione di riga non crea un'interruzione di pagina. Se la sezione successiva richiede un nuovo foglio nel documento esportato, consulta la guida alle interruzioni di pagina in Markdown.

Perché premere Invio può sembrare uno spazio

Prova questo sorgente:

La bozza è pronta.
Chi si occupa della revisione può aprirla oggi.

Nell'anteprima di questo sito, entrambe le frasi appartengono a un solo paragrafo e scorrono insieme. Il ritorno a capo resta utile nel file sorgente, ma non obbliga il browser a iniziare una nuova riga visualizzata. Il browser può comunque distribuire il testo in base alla larghezza disponibile.

Ora inserisci una riga vuota:

La bozza è pronta.

Chi si occupa della revisione può aprirla oggi.

L'anteprima produce due paragrafi. Usa questa versione quando la seconda frase introduce un nuovo pensiero. Aggiungere più righe vuote non è un metodo affidabile per richiedere maggiore spazio verticale; lo stile dei paragrafi dipende dal motore di rendering o dal modello del documento.

Barra inversa o due spazi finali

CommonMark definisce sia due spazi prima di un ritorno a capo sia una barra inversa prima del ritorno come sintassi per un'interruzione di riga forzata all'interno di un paragrafo. Gli esempi di interruzioni di riga forzate di CommonMark documentano entrambe le forme.

La versione con barra inversa è visibile durante la revisione di un file:

Preparato dal team della documentazione\
Revisionato dal responsabile della versione

L'alternativa consiste nel digitare esattamente due spazi dopo documentazione, quindi premere Invio. Questi spazi sono invisibili in molti editor e possono essere rimossi dalla pulizia automatica degli spazi finali. Se un'interruzione scompare dopo il salvataggio, controlla le impostazioni degli spazi bianchi oppure usa la barra inversa.

Non digitare i due caratteri \n nel testo normale aspettandoti un'interruzione. È una convenzione delle stringhe di programmazione, non un ritorno a capo Markdown. Evita anche di mettere una barra inversa alla fine di un paragrafo: un'interruzione forzata richiede un'altra riga di contenuto dello stesso paragrafo dopo di essa.

I commenti di GitHub e i file README si comportano diversamente

La documentazione di GitHub sulle interruzioni di riga distingue i file .md del repository da segnalazioni, richieste di modifica e discussioni. I normali ritorni a capo possono apparire come interruzioni in queste aree di conversazione, mentre un README richiede una sintassi esplicita per le interruzioni forzate.

Questa differenza spiega perché il testo copiato da una segnalazione può apparire diverso in un README. Controlla il file di destinazione invece di presumere che ogni sezione dello stesso sito usi regole di formattazione identiche.

Mantieni la continuazione all'interno di una voce di elenco

Applica un rientro alla continuazione per allinearla all'inizio del testo della voce:

- Note di rilascio\
  Includi le istruzioni di migrazione.
- Guida all'installazione

Qui la prima voce contiene due righe visualizzate. La seconda rimane separata. Per inserire un paragrafo separato nella prima voce, usa una riga vuota e mantieni il rientro della continuazione:

- Note di rilascio

  Includi le istruzioni di migrazione e i problemi noti.
- Guida all'installazione

La guida ai rientri tratta elenchi numerati, punti elenco annidati e codice all'interno di una voce.

Inserisci una nuova riga in una cella di tabella Markdown

Una riga di tabella GFM deve occupare una sola riga del sorgente. Premere Invio all'interno del contenuto può spezzare la riga della tabella. Nei motori di rendering che consentono le interruzioni di riga HTML, usa questo schema:

| Documento | Responsabili |
| --- | --- |
| Note di rilascio | Redattore<br>Revisore |

L'anteprima di questo sito supporta l'esempio. Una destinazione che rimuove HTML potrebbe eliminare l'interruzione o mostrare il tag, quindi verifica la piattaforma prima di adottarlo in tutto il documento. Un elenco esterno alla tabella è spesso più facile da mantenere quando una cella richiede diversi paragrafi.

Usa il generatore di tabelle Markdown per i dati tabulari e la guida alla sintassi delle tabelle per l'allineamento e le barre verticali con escape.

Controlla il documento esportato

Prima di usare il convertitore da Markdown a Word, prova un breve campione con un normale ritorno a capo, un'interruzione forzata esplicita e una riga vuota. L'anteprima dovrebbe mostrare rispettivamente un paragrafo continuo, un'interruzione di riga forzata e due paragrafi separati.

Apri il DOCX scaricato e controlla l'indirizzo, gli elenchi e la tabella. La larghezza della pagina e gli stili di paragrafo di Word possono modificare la distribuzione delle righe anche quando le interruzioni sottostanti sono corrette. Correggi prima la struttura Markdown; regola la tipografia finale in Word quando un particolare modello di documento lo richiede.