Saltos de línea en Markdown: líneas nuevas, párrafos y celdas
Añade una línea nueva en Markdown con una barra invertida, dos espacios o una línea en blanco. Corrige los saltos en README, listas y tablas antes de exportar a Word.
Para empezar una línea nueva dentro de un párrafo de Markdown, escribe una barra invertida al final de la primera línea y pulsa Intro. Para empezar otro párrafo, deja una línea en blanco. Estas opciones generan estructuras diferentes en el documento, algo importante cuando después exportas un README, una dirección o un informe a Word.
Equipo de documentación\
Calle Ejemplo, 42\
Portland, Oregón
La dirección permanece en un solo párrafo que se muestra en tres líneas. Pégala en la vista previa de Markdown para compararla con los ejemplos siguientes.
Elige el tipo de salto que necesitas
| Resultado deseado | Código Markdown | Uso habitual |
|---|---|---|
| Continuar el mismo párrafo | Un salto de línea normal | Dividir líneas largas en el archivo fuente |
| Empezar otra línea en el mismo párrafo | Barra invertida seguida de Intro | Direcciones y versos breves |
| Empezar un párrafo nuevo | Una línea en blanco | Separar ideas en un artículo |
| Introducir un salto dentro de una celda | <br> donde se admita HTML | Dos etiquetas cortas en una celda |
Un salto de línea no crea un salto de página. Si la siguiente sección necesita una hoja nueva en el documento exportado, consulta la guía de saltos de página en Markdown.
Por qué pulsar Intro puede parecer un espacio
Prueba este código:
El borrador está listo.
La persona encargada de revisarlo puede abrirlo hoy.
En la vista previa de este sitio, ambas frases pertenecen al mismo párrafo y se muestran seguidas. El salto sigue siendo útil en el archivo fuente, pero no obliga al navegador a empezar una línea nueva en pantalla. El navegador puede seguir ajustando el texto al ancho disponible.
Ahora introduce una línea vacía:
El borrador está listo.
La persona encargada de revisarlo puede abrirlo hoy.
La vista previa genera dos párrafos. Usa esta versión cuando la segunda frase introduzca otra idea. Añadir varias líneas vacías no es una forma fiable de solicitar más espacio vertical; el estilo de los párrafos corresponde al renderizador o a la plantilla del documento.
Barra invertida o dos espacios finales
CommonMark define tanto dos espacios antes de un salto de línea como una barra invertida antes del salto como sintaxis de salto forzado dentro de un párrafo. Los ejemplos de saltos de línea forzados de CommonMark documentan ambas formas.
La barra invertida resulta visible al revisar un archivo:
Preparado por el equipo de documentación\
Revisado por la persona responsable de la versión
La alternativa es escribir exactamente dos espacios después de documentación y pulsar Intro. Esos espacios son invisibles en muchos editores y la limpieza automática de espacios finales puede eliminarlos. Si un salto desaparece al guardar, revisa la configuración de espacios en blanco o usa la barra invertida.
No escribas los dos caracteres \n en texto corriente esperando un salto. Esa es una convención de las cadenas de programación, no un salto de línea de Markdown. Evita también poner una barra invertida al final de un párrafo: un salto forzado necesita que después haya otra línea de contenido del mismo párrafo.
Los comentarios de GitHub y los archivos README se comportan de manera diferente
La documentación de GitHub sobre saltos de línea distingue los archivos .md de un repositorio de las incidencias, solicitudes de cambios y debates. Los saltos normales pueden mostrarse como saltos de línea en esas conversaciones, mientras que un README necesita la sintaxis explícita de salto forzado.
Esa diferencia explica por qué el texto copiado de una incidencia puede verse distinto en un README. Revisa el archivo de destino en lugar de dar por hecho que todas las secciones de un mismo sitio web usan reglas de formato idénticas.
Mantén la continuación dentro de un elemento de lista
Aplica sangría a la continuación para alinearla con el comienzo del texto del elemento:
- Notas de la versión\
Incluye las instrucciones de migración.
- Guía de instalación
Aquí el primer elemento se muestra en dos líneas. El segundo sigue siendo independiente. Para incluir un párrafo separado dentro del primer elemento, usa una línea en blanco y conserva la sangría de la continuación:
- Notas de la versión
Incluye las instrucciones de migración y los problemas conocidos.
- Guía de instalación
La guía de sangría explica las listas numeradas, las viñetas anidadas y el código dentro de un elemento.
Añade una línea nueva en una celda de tabla Markdown
Cada fila de una tabla GFM debe ocupar una sola línea del archivo fuente. Pulsar Intro dentro de su contenido puede dividir la fila. En renderizadores que permitan saltos de línea HTML, usa este patrón:
| Documento | Responsables |
| --- | --- |
| Notas de la versión | Redactor<br>Revisor |
La vista previa de este sitio admite este ejemplo. Un destino que elimine el HTML podría quitar el salto o mostrar la etiqueta, así que comprueba esa plataforma antes de usarlo en todo el documento. Cuando una celda necesita varios párrafos, una lista fuera de la tabla suele ser más fácil de mantener.
Usa el generador de tablas Markdown para los datos tabulares y la guía de sintaxis de tablas para la alineación y las barras verticales escapadas.
Comprueba el documento exportado
Antes de usar el conversor de Markdown a Word, prueba una muestra breve que contenga un salto de línea normal, uno forzado explícitamente y una línea en blanco. La vista previa debería mostrar, respectivamente, un párrafo continuo, un salto de línea forzado y dos párrafos separados.
Abre el DOCX descargado y revisa la dirección, las listas y la tabla. El ancho de página y los estilos de párrafo de Word pueden cambiar el ajuste de líneas aunque los saltos subyacentes sean correctos. Corrige primero la estructura de Markdown; ajusta la tipografía final en Word cuando una plantilla concreta lo requiera.