Gerador de Link Markdown

As quatro variantes de link

Inline, sem título:

[Leia a documentação](https://example.com/docs)

Inline com título (tooltip ao passar o mouse):

[Leia a documentação](https://example.com/docs "Documentação completa")

Estilo de referência (URL definida abaixo):

Abra a [documentação][docs] ou o [changelog][cl].

[docs]: https://example.com/docs
[cl]:   https://example.com/changelog

Autolink (URL é tanto texto quanto alvo):

<https://example.com>

Quando escolher qual

• Inline para links ocasionais onde a URL é curta e o parágrafo ainda é legível.
• Estilo de referência quando você está citando a mesma URL várias vezes, ou quando a URL é um monstro de rastreamento de 200 caracteres que, de outra forma, quebraria o fluxo do parágrafo.
• Autolink para “aqui está nossa página de documentação” onde você realmente quer que a URL apareça como texto e alvo.

Higiene de caracteres especiais

• Espaços em URLs precisam de %20 ou o link quebra no espaço.
• Parênteses na URL precisam de codificação de URL como %28 e %29, caso contrário, o parser Markdown os consome.
• Colchetes quadrados no texto âncora devem ser escapados como \[ e \] para evitar que o parser os trate como sintaxe de link aninhada.

Dicas de acessibilidade

• Evite “clique aqui”. Texto âncora como clique aqui ou leia mais é inútil quando usuários de leitores de tela navegam pelos links. Use texto descritivo: [guia de instalação](...).
• Não coloque a URL em si como texto âncora para URLs longas, é hostil para tecnologia assistiva e feio na impressão.
• Abrir em nova aba é HTML bruto (target="_blank"), não Markdown. A maioria dos renderizadores que aceitam HTML bruto respeitará isso; o CommonMark puro não fará.

Atalho de uma linha

Em comentários do GitHub, colar uma URL ao lado do texto selecionado a converte automaticamente em um link Markdown. Útil quando você já está no editor.