Como sublinhar no Markdown

Ao contrário da formatação em negrito e itálico, não há sintaxe de sublinhado de marcação nativa incorporada na linguagem. O Markdown foi projetado para ser mapeado próximo ao HTML e, como o texto sublinhado é facilmente confundido com hiperlinks na web, os criadores o deixaram de fora intencionalmente.

Isso não significa que você está sem sorte. Existem várias maneiras confiáveis ​​de sublinhar na redução, dependendo da plataforma que você está usando e de quanto controle você tem sobre a saída renderizada.

Este guia percorre todos os métodos para que você possa sublinhar o texto remarcado em qualquer situação.

Por que Markdown não tem sintaxe de sublinhado

Markdown foi criado por John Gruber em 2004 como uma maneira simples de escrever conteúdo que seja convertido de forma limpa em HTML. Negrito usa asteriscos duplos, itálico usa asteriscos únicos e tachado usa tils em alguns sabores. Mas o sublinhado foi deliberadamente excluído.

O raciocínio é prático. Na web, o texto sublinhado quase sempre indica um link clicável. Se o markdown permitisse o sublinhado nativo, os leitores confundiriam constantemente as palavras sublinhadas com hiperlinks, criando uma experiência confusa. A maioria dos guias de estilo para conteúdo da web também desencoraja o sublinhado pelo mesmo motivo.

Ainda assim, há casos legítimos em que você precisa sublinhar o texto na marcação, como textos acadêmicos, documentos formais ou plataformas onde os links têm estilos diferentes.

Como sublinhar em Markdown usando HTML

O método mais amplamente suportado para sublinhar o texto markdown é usar a tag HTML <u> diretamente:

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

Isso é renderizado como: Este é um texto sublinhado em uma frase.

Como a maioria dos analisadores de markdown permitem HTML embutido, essa abordagem funciona no GitHub, GitLab, Jupyter Notebooks e em muitos geradores de sites estáticos. É a resposta mais direta para quem procura maneiras de criar sintaxe de sublinhado de markdown, embora tecnicamente use HTML em vez de markdown puro.

Quando a tag <u> pode não funcionar

Algumas plataformas eliminam tags HTML por motivos de segurança. Discord, Slack e alguns editores de CMS irão ignorar ou remover totalmente as tags <u>. Se você estiver trabalhando em um desses ambientes, precisará de uma abordagem diferente.

Usando CSS para sublinhar texto em Markdown

Se você tiver acesso a estilos personalizados, o CSS oferece mais flexibilidade. Você pode usar uma tag <span> com um estilo embutido:

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

Alternativamente, se você controla a folha de estilo do seu site ou documentação, você pode definir uma classe personalizada:

.underline {
  text-decoration: underline;
}

Em seguida, use-o em sua redução:

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

Este método é ideal para blogs, sites de documentação e qualquer ambiente onde você gerencia CSS. Ele mantém sua redução mais limpa do que os estilos embutidos e oferece uma formatação consistente em todo o projeto.

Markdown Underline em plataformas específicas

Diferentes plataformas lidam com a formatação de sublinhado à sua maneira. Veja como abordá-lo nos ambientes mais comuns.

GitHub

GitHub Flavored Markdown oferece suporte a HTML embutido, portanto, a tag <u> funciona em arquivos README, problemas, descrições de pull request e comentários. Isso o torna o método de sublinhado de marcação mais fácil para usuários do GitHub.

Cadernos Jupyter

Jupyter renderiza células markdown com suporte HTML completo. Tanto a tag <u> quanto as abordagens baseadas em CSS funcionam de maneira confiável. Você também pode usar a tag <ins>, que representa semanticamente o texto inserido, mas é renderizado com um sublinhado por padrão:

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

Discórdia e folga

Nem o Discord nem o Slack suportam marcação de sublinhado nativamente. O Discord usa sua própria variação de markdown, mas não inclui nenhuma sintaxe de sublinhado. O Slack usa inteiramente seu próprio sistema de formatação. Em ambos os casos, não há solução alternativa na própria entrada de mensagens.

Aplicativos de obsidiana e anotações

Alguns aplicativos de anotações, como o Obsidian, oferecem suporte a trechos CSS personalizados. Se seu aplicativo permitir, você pode definir uma classe de sublinhado em seu CSS e referenciá-la em suas notas. Verifique a documentação específica do seu aplicativo para obter detalhes sobre como ativar estilos personalizados.

Usando a tag <ins> como alternativa

A tag <ins> é um elemento HTML que representa o texto que foi inserido em um documento. Os navegadores o renderizam com um sublinhado por padrão, tornando-o uma alternativa semântica à tag <u>:

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

A diferença entre <u> e <ins> é principalmente sobre significado. Use <u> quando desejar simplesmente sublinhado visual. Use <ins> quando quiser indicar que o texto foi adicionado ou alterado, como em uma revisão ou histórico de edição.

Ambas as tags produzem o mesmo resultado visual na maioria dos analisadores de markdown que suportam HTML.

Soluções alternativas quando HTML não é compatível

Se você estiver trabalhando em uma plataforma que remove tags HTML e não tem suporte para sublinhados, suas opções são limitadas. Aqui estão algumas soluções alternativas comuns que as pessoas usam:

Sublinhado falso com caracteres Unicode. Você pode usar a combinação de caracteres Unicode para simular um sublinhado, mas isso não é confiável em fontes e plataformas e geralmente não é recomendado.

Use negrito ou itálico. Se o objetivo for simplesmente chamar a atenção para um texto específico, a formatação em negrito ou itálico pode servir ao mesmo propósito sem a necessidade de sublinhado.

Adicione uma nota entre parênteses. Em ambientes de texto simples, alguns escritores indicam ênfase adicionando uma nota como "(ênfase minha)" após o texto relevante.

Nenhum deles é um verdadeiro substituto para o texto sublinhado de marcação, mas pode ajudar em ambientes restritos.

Referência rápida

Aqui está um resumo de cada método para sublinhar texto na marcação:

• <u>text</u> é o método mais simples e mais amplamente suportado.
• <ins>text</ins> é uma alternativa semântica que também é renderizada como sublinhada.
• CSS com tags <span> oferece maior controle ao gerenciar a folha de estilo.
• Não existe nenhuma sintaxe de sublinhado de marcação nativa, portanto, todos os métodos dependem de HTML ou de recursos específicos da plataforma.
• GitHub e Jupyter suportam sublinhado baseado em HTML.
• Discord e Slack não suportam qualquer forma de formatação de sublinhado.

Considerações Finais

A falta de uma sintaxe de sublinhado de marcação integrada é uma escolha deliberada de design, não um descuido. Para a maior parte do conteúdo da web, evitar sublinhados mantém o texto claro e evita confusão com links. Mas quando você precisa sublinhar o texto no markdown, a tag <u> é a solução mais rápida e portátil. Escolha o método que se adapta à sua plataforma, tenha em mente a legibilidade e seus documentos terão a aparência exata que você deseja.