Cómo subrayar en Markdown

A diferencia del formato en negrita y cursiva, no existe una sintaxis de subrayado de rebajas nativa integrada en el idioma. Markdown fue diseñado para mapear estrechamente con HTML y, dado que el texto subrayado se confunde fácilmente con hipervínculos en la web, los creadores lo omitieron intencionalmente.

Eso no significa que no tengas suerte. Hay varias formas confiables de subrayar en Markdown dependiendo de la plataforma que esté utilizando y de cuánto control tenga sobre la salida renderizada.

Esta guía explica todos los métodos para que pueda subrayar el texto de rebajas en cualquier situación.

Por qué Markdown no tiene sintaxis de subrayado

Markdown fue creado por John Gruber en 2004 como una forma sencilla de escribir contenido que se convierta limpiamente a HTML. La negrita usa asteriscos dobles, la cursiva usa asteriscos simples y el tachado usa tildes en algunas versiones. Pero el subrayado fue excluido deliberadamente.

El razonamiento es práctico. En la web, el texto subrayado casi siempre indica un enlace en el que se puede hacer clic. Si Markdown permitiera el subrayado nativo, los lectores confundirían constantemente las palabras subrayadas con hipervínculos, creando una experiencia confusa. La mayoría de las guías de estilo para contenido web también desaconsejan el subrayado por el mismo motivo.

Aun así, existen casos legítimos en los que es necesario subrayar texto en Markdown, como escritos académicos, documentos formales o plataformas donde los enlaces tienen un estilo diferente.

Cómo subrayar en Markdown usando HTML

El método más ampliamente admitido para subrayar texto de rebajas es utilizar la etiqueta HTML <u> directamente:

This is <u>underlined text</u> in a sentence.

Esto se representa como: Este es texto subrayado en una oración.

Dado que la mayoría de los analizadores de rebajas permiten HTML en línea, este enfoque funciona en GitHub, GitLab, Jupyter Notebooks y muchos generadores de sitios estáticos. Es la respuesta más sencilla para cualquiera que busque formas de crear una sintaxis de subrayado de rebajas, aunque técnicamente utiliza HTML en lugar de rebajas puras.

Cuando es posible que la etiqueta <u> no funcione

Algunas plataformas eliminan las etiquetas HTML por motivos de seguridad. Discord, Slack y ciertos editores de CMS ignorarán o eliminarán las etiquetas <u> por completo. Si trabaja en uno de estos entornos, necesitará un enfoque diferente.

Uso de CSS para subrayar texto en Markdown

Si tiene acceso a estilos personalizados, CSS le brinda la mayor flexibilidad. Puedes usar una etiqueta <span> con un estilo en línea:

This is <span style="text-decoration: underline;">underlined text</span> in a sentence.

Alternativamente, si controlas la hoja de estilo de tu sitio o documentación, puedes definir una clase personalizada:

.underline {
  text-decoration: underline;
}

Luego úselo en su rebaja:

This is <span class="underline">underlined text</span> in a sentence.

Este método es ideal para blogs, sitios de documentación y cualquier entorno donde administre CSS. Mantiene su descuento más limpio que los estilos en línea y le brinda un formato consistente en todo el proyecto.

Subrayado de rebajas en plataformas específicas

Las diferentes plataformas manejan el formato de subrayado a su manera. A continuación se explica cómo abordarlo en los entornos más comunes.

GitHub

GitHub Flavored Markdown admite HTML en línea, por lo que la etiqueta <u> funciona en archivos README, incidencias, descripciones de solicitudes de extracción y comentarios. Esto lo convierte en el método de subrayado de rebajas más sencillo para los usuarios de GitHub.

Cuadernos Jupyter

Jupyter representa celdas de rebajas con soporte completo para HTML. Tanto la etiqueta <u> como los enfoques basados ​​en CSS funcionan de manera confiable. También puedes usar la etiqueta <ins>, que representa semánticamente el texto insertado pero se muestra con un subrayado de forma predeterminada:

This is <ins>underlined text</ins> in a notebook.

Discordia y holgura

Ni Discord ni Slack admiten la reducción de subrayado de forma nativa. Discord usa su propia variación de Markdown, pero no incluye ninguna sintaxis de subrayado. Slack utiliza su propio sistema de formato por completo. En ambos casos, no existe ninguna solución alternativa dentro de la propia entrada de mensajes.

Aplicaciones de obsidiana y para tomar notas

Algunas aplicaciones para tomar notas como Obsidian admiten fragmentos de CSS personalizados. Si su aplicación lo permite, puede definir una clase de subrayado en su CSS y hacer referencia a ella en sus notas. Consulte la documentación de su aplicación específica para obtener detalles sobre cómo habilitar estilos personalizados.

Uso de la etiqueta <ins> como alternativa

La etiqueta <ins> es un elemento HTML que representa el texto que se ha insertado en un documento. Los navegadores lo muestran con un subrayado de forma predeterminada, lo que lo convierte en una alternativa semántica a la etiqueta <u>:

The meeting is on <ins>Thursday</ins>, not Wednesday.

La diferencia entre <u> y <ins> tiene que ver principalmente con el significado. Utilice <u> cuando simplemente desee un subrayado visual. Utilice <ins> cuando desee indicar que se ha agregado o modificado texto, como en una revisión o en el historial de edición.

Ambas etiquetas producen el mismo resultado visual en la mayoría de los analizadores de rebajas que admiten HTML.

Soluciones alternativas cuando HTML no es compatible

Si está trabajando en una plataforma que elimina las etiquetas HTML y no admite subrayado, sus opciones son limitadas. A continuación se muestran algunas soluciones alternativas comunes que utiliza la gente:

Subrayado falso con caracteres Unicode. Puede utilizar Unicode combinando caracteres para simular un subrayado, pero esto no es confiable en todas las fuentes y plataformas y, en general, no se recomienda.

Utilice negrita o cursiva en su lugar. Si el objetivo es simplemente llamar la atención sobre un texto específico, el formato en negrita o cursiva puede servir para el mismo propósito sin necesidad de subrayar.

Agregue una nota entre paréntesis. En entornos de texto sin formato, algunos escritores indican énfasis agregando una nota como "(énfasis mío)" después del texto relevante.

Ninguno de estos son verdaderos sustitutos del texto subrayado con rebajas, pero pueden ayudar en entornos restringidos.

Referencia rápida

Aquí hay un resumen de cada método para subrayar texto en rebajas:

• <u>text</u> es el método más simple y más compatible.
• <ins>text</ins> es una alternativa semántica que también se muestra subrayada.
• CSS con etiquetas <span> brinda el mayor control cuando administras la hoja de estilo.
• No existe una sintaxis nativa de subrayado de rebajas, por lo que todos los métodos se basan en HTML o características específicas de la plataforma.
• GitHub y Jupyter admiten subrayado basado en HTML.
• Discord y Slack no admiten ningún tipo de formato de subrayado.

Pensamientos finales

La falta de una sintaxis de subrayado de rebajas incorporada es una elección de diseño deliberada, no un descuido. Para la mayoría del contenido web, evitar los subrayados mantiene el texto claro y evita confusión con los enlaces. Pero cuando necesita subrayar texto en Markdown, la etiqueta <u> es la solución más rápida y portátil. Elija el método que se adapte a su plataforma, tenga en cuenta la legibilidad y sus documentos tendrán el aspecto exacto que desea.