Markdown no tiene sintaxis nativa para subrayar texto. En CommonMark y GitHub Flavored Markdown, _texto_ significa cursiva y __texto__ significa negrita. El subrayado suele requerir compatibilidad con HTML o una extensión específica de la aplicación.
En GitHub, la forma documentada es:
El <ins>plazo revisado</ins> termina el viernes.GitHub incluye <ins>...</ins> para texto subrayado en su documentación de formato básico. Es una opción HTML compatible con la plataforma, no un nuevo delimitador Markdown que funcione en todas partes.
Comparación de subrayado, negrita y cursiva
| Código | Significado | Dónde cabe esperarlo |
|---|---|---|
_importante_ |
Énfasis, normalmente cursiva | CommonMark y GFM |
__importante__ |
Énfasis fuerte, normalmente negrita | CommonMark y GFM |
**importante** |
Énfasis fuerte, normalmente negrita | CommonMark y GFM |
<ins>texto añadido</ins> |
Texto insertado, normalmente subrayado | Renderizadores con HTML habilitado; documentado por GitHub |
<u>texto anotado</u> |
Anotación HTML, normalmente subrayada | Renderizadores que permiten este elemento HTML |
Elige negrita o cursiva cuando quieras expresar énfasis. Por ejemplo, **Entrega el viernes** sigue siendo útil en un README, una nota y una exportación Markdown sin depender de HTML sin procesar.
¿Qué diferencia hay entre ins y u?
Las dos etiquetas pueden parecer similares, pero tienen significados distintos.
<ins> representa texto insertado en un documento. Encaja en una revisión, como un requisito recién añadido. El navegador suele subrayarlo, aunque una hoja de estilos puede cambiar su apariencia. Consulta la referencia de texto insertado de MDN.
La versión admite <ins>importaciones CSV y TSV</ins>.<u> marca una anotación que no es un énfasis corriente, como señalar un error ortográfico. El HTML moderno no la define como una etiqueta genérica para «dar importancia». Consulta la referencia del elemento u de MDN.
Revisa la ortografía de <u>recivir</u>.Si controlas un sitio web y necesitas un subrayado puramente visual, aplica text-decoration: underline mediante CSS. Una plataforma Markdown alojada puede eliminar atributos de estilo o impedir estilos personalizados, así que este enfoque tampoco es portable.
¿Por qué el subrayado funciona en un editor y desaparece en otro?
Hay tres decisiones independientes: el analizador Markdown reconoce HTML, la aplicación decide qué etiquetas permite y la hoja de estilos del destino determina cómo se ven los elementos permitidos. Admitir GFM no garantiza que un producto permita todas las etiquetas HTML.
El editor de MD File Viewer elimina actualmente las etiquetas HTML sin procesar de la entrada del usuario. Si pegas <ins>texto añadido</ins> o <u>texto anotado</u>, quedan las palabras sin esas etiquetas, por lo que la vista previa no las subraya. Utiliza esa vista previa para el formato Markdown compatible y comprueba el formato basado en HTML en el destino donde se publicará.
Si estás trasladando un documento HTML a Markdown, el convertidor HTML a Markdown ayuda a recuperar el texto, los encabezados, los enlaces y las listas. El subrayado y el CSS personalizado pueden perderse porque Markdown simple no tiene sintaxis equivalente. Comprueba el resultado antes de sustituir el documento original.
Ejemplos para un README de GitHub
Para una breve adición en una nota de cambios, la opción HTML documentada por GitHub es:
Esta versión añade <ins>un paso de importación opcional</ins>.Para un plazo o requisito, utiliza énfasis Markdown:
**Obligatorio:** Incluye una fila de encabezado en el archivo CSV.Para un destino, utiliza un enlace:
[Leer las instrucciones de importación](https://example.com/import)El texto subrayado puede parecer un enlace pulsable. Evita que las etiquetas normales parezcan interactivas, especialmente si el mismo párrafo contiene enlaces reales. La guía de enlaces Markdown explica los textos de enlace descriptivos y los enlaces de referencia.
Errores habituales con el subrayado
Los guiones bajos dobles ponen el texto en negrita. Cambiar **palabra** por __palabra__ cambia el delimitador, no el significado. Ambos representan énfasis fuerte.
Los acentos graves muestran la etiqueta como código. Escribir `<ins>texto</ins>` resulta útil en un tutorial, pero muestra intencionadamente el marcado en lugar de renderizarlo.
Los atajos de teclado pertenecen a la aplicación. Un editor de texto enriquecido puede ofrecer una orden de subrayado y guardar HTML o su propio formato de documento. Eso no convierte el subrayado en parte del Markdown portable.
Un encabezado subrayado es un concepto distinto. En este código, los guiones crean un encabezado de nivel dos:
Notas de la versión
-------------No subrayan una frase dentro de un párrafo. Para separar secciones, utiliza una línea horizontal Markdown con líneas en blanco alrededor.
Preguntas frecuentes
¿Cómo subrayo en Markdown en GitHub?
Utiliza <ins>texto</ins>, que GitHub documenta para subrayar. Para expresar énfasis en renderizadores sin compatibilidad con HTML, utiliza **texto** o *texto*.
¿Existe una alternativa de subrayado solo con Markdown?
No hay un delimitador estándar de subrayado. Algunas aplicaciones añaden su propia sintaxis, pero debes comprobar su documentación y el formato que utilizan al exportar.
¿Se conservará el subrayado al convertir Markdown a PDF o Word?
Solo si el convertidor conserva el HTML o la extensión correspondiente y admite sus estilos. No des por hecho que un subrayado visible en la vista previa de una aplicación se conservará con otro exportador. Inspecciona el archivo resultante o utiliza negrita estándar cuando la portabilidad sea importante.
La chuleta de Markdown ofrece una referencia compacta del formato que dispone de sintaxis Markdown propia.
Pruébalo en tu navegador
Abre el editor de la página principal para ver, editar y exportar Markdown al instante, sin instalación.