Gerador de links Markdown

Cole a URL e escreva o texto que vai aparecer no link. O código fica pronto para copiar para o README, a documentação ou suas notas. Para vários links, use Em lote.

Preencha o texto e o destino para ver o código Markdown.
Prévia

Links para seções com acentos e títulos repetidos no GitHub

No GitHub, os acentos de títulos como Instalação e Visão geral são mantidos nas âncoras. Os espaços viram hífens, e um título repetido recebe um sufixo para distinguir seu destino. A documentação do GitHub sobre links de seção descreve essas regras e como copiar a âncora pelo ícone ao lado do título.

No exemplo abaixo, os três títulos aparecem nesta ordem no mesmo README, sem outras seções com essas âncoras. Escolha Com texto, informe a âncora no campo de destino e escreva o texto do link. O gerador usa o destino informado; não calcula a âncora a partir do título.

Se você renomear ou reorganizar as seções, confira novamente as âncoras no GitHub. Outros editores podem seguir regras diferentes. Para criar uma lista de links a partir dos títulos do documento, use o gerador de sumário Markdown.

Exemplo de âncoras com acentos e título repetido em um README no GitHub
Título no README, na ordem do arquivoÂncora no GitHubCódigo gerado
## Instalação#instalação[Instalação](<#instalação>)
## Visão geral#visão-geral[Visão geral](<#visão-geral>)
## Instalação#instalação-1[Instalação alternativa](<#instalação-1>)

Link Markdown não funciona? Confira espaços, parênteses e caminhos

Um código bem formado ainda pode apontar para o lugar errado. O gerador confere o formato do destino, mas não verifica se a página, o arquivo ou a seção existe. Se o link no README não funciona, confira primeiro a pasta de origem, o nome do arquivo e as letras maiúsculas e minúsculas.

Para um link com espaço em Markdown, cole o caminho completo: o gerador troca os espaços por %20. Nos formatos Com texto, Por referência e Imagem, ele delimita o destino com < >, inclusive quando há parênteses no endereço. Colchetes no texto do link recebem uma barra de escape.

A forma [texto](<destino>) é válida na especificação CommonMark para links. Os sinais < > delimitam o destino no código e não aparecem no texto do link renderizado.

Nos caminhos relativos, use ./ para partir da pasta atual ou ../ para subir uma pasta. Caminhos que começam com / também são aceitos; a plataforma em que você publica define qual raiz será usada. A prévia desta página não reproduz as pastas do seu repositório.

Exemplos de saída para destinos com espaços e parênteses
SituaçãoDestino informadoCódigo gerado
Nome de arquivo com espaço./docs/guia inicial.md[Guia inicial](<./docs/guia%20inicial.md>)
URL com parênteseshttps://example.com/guia(2)[Guia revisado](<https://example.com/guia(2)>)

Dúvidas sobre links em Markdown

Respostas para quem está ajustando o README, organizando referências ou conferindo o resultado no editor.

Como criar um link para uma seção no README?

Copie a âncora da seção na plataforma em que o README será publicado e cole no campo URL ou caminho de destino. Escolha Com texto e escreva o nome que deve aparecer. Se a âncora copiada for #instalação e o texto for Instalação, o gerador entrega [Instalação](<#instalação>). Ele usa a âncora informada; não a calcula a partir do título.

Por que a âncora Markdown não funciona no GitHub?

Confira se o destino depois de # corresponde à âncora atual da seção. Para títulos como Instalação ou Visão geral, copie o destino pelo ícone de link ao lado do título no GitHub, em vez de tentar adivinhar como ficam os acentos. Confira também títulos repetidos e se a seção foi renomeada. Uma âncora usada em outro editor pode seguir regras diferentes.

Por que o link aparece como código em vez de ficar clicável?

Confira se você colou o resultado em uma área que aceita Markdown. Dentro de um bloco de código ou entre crases, a sintaxe aparece como texto. Ao editar um arquivo .md, veja a prévia ou a versão renderizada para conferir a aparência do link.

Como converter uma lista de URLs em links Markdown sem digitar os textos?

Selecione Em lote e Link automático. Cole um site ou e-mail por linha, sem o separador |. O próprio endereço será o texto visível. Para dar nomes aos links, como Documentação e Portfólio, escolha Com texto e use uma linha no formato texto | destino.

Como transformar uma imagem em link no Markdown?

Primeiro, gere a imagem no modo Imagem. Depois, no seu documento, envolva o código em um link para o destino desejado. Exemplo: [![Tela do projeto](<./imagens/tela.png>)](<https://example.com/demo>). A imagem será o conteúdo do link. O gerador cria a parte da imagem; essa combinação deve ser montada por você.

Como abrir um link Markdown em nova aba?

O link padrão do Markdown não tem uma opção para definir nova aba. A prévia deste gerador abre links em outra aba, mas essa configuração não acompanha o código copiado. No documento publicado, o comportamento depende da plataforma. HTML com target só pode ser usado quando o editor ou site permite esse atributo.

Converter URL em link Markdown também converte o conteúdo da página?

Aqui, você informa um endereço e recebe o código para apontar para ele. A ferramenta não extrai o texto da página, não encurta a URL e não publica o seu documento. Para transformar o conteúdo de um site em Markdown, é necessário um conversor de página web.

O gerador precisa acessar os endereços que eu informo?

A geração do código, a verificação do formato e a cópia acontecem no navegador, sem consultar a página de destino. Por isso, a ferramenta não confirma se o endereço existe. A prévia de uma imagem pode carregar o arquivo do endereço informado, e abrir um link acessa o destino.

Deixe os links do seu README prontos para colar

Adicione a documentação, a demonstração e os arquivos do projeto. Confira o código e a prévia antes de copiar.