Extrator de links Markdown
Extraia todos os links escondidos em um documento Markdown e reúna-os em uma lista clara, cada um com seu texto âncora, sua URL e o número da linha. Os links em linha escritos como [texto](url) são listados separadamente das imagens escritas como , então você vê de relance qual linha contém qual referência. A extração roda assim que você cola o texto, e o resultado fica pronto para copiar como texto puro.
💡 Sobre esta ferramenta
Quando você mantém um README longo ou um artigo de blog, mais cedo ou mais tarde precisa revisar os links que ele contém: contá-los, achar os quebrados ou jogar todas as URLs de destino em uma planilha. Buscar ]( no editor funciona, mas você ainda tem que contar as ocorrências, anotar os números de linha e separar imagens de links a olho. Esta ferramenta percorre o texto com uma expressão regular que detecta o padrão [...](...) e alinha cada ocorrência com o número da linha e um rótulo de tipo (link ou imagem). Como divide em entradas separadas os vários links de uma mesma linha, tarefas como somar o total de links ou ficar só com as URLs se resolvem com uma única colagem. Ela é voltada para engenheiros que trabalham com documentação técnica, redatores de documentação e qualquer pessoa que faça anotações em Markdown.
🧐 Perguntas frequentes
Ela separa imagens de links?
Sim. Tudo que começa com !, como , é rotulado como imagem; um [texto](url) simples é rotulado como link, e os dois tipos aparecem de forma distinta.
Ela detecta links de estilo de referência ([texto][ref] com um [ref]: url à parte)?
Esta ferramenta foca nos links em linha escritos como [texto](url). Os links de referência que definem a URL em uma linha separada ficam fora do seu alcance.
As URLs soltas (um https://... digitado direto) são extraídas?
Não. Só são detectados os links envolvidos pela sintaxe [ ]( ) do Markdown. O par de colchetes e parênteses é o sinal que a ferramenta procura.
O que acontece quando uma linha tem vários links? Cada ocorrência encontrada nessa linha é listada como uma entrada própria, e o mesmo número de linha se repete para cada uma.
📚 Curiosidades
A sintaxe de links do Markdown [texto](url) faz parte do formato desde que John Gruber publicou a primeira versão em 2004, pensada para poupar quem escreve de digitar à mão o HTML <a href>. Variantes posteriores como o GitHub Flavored Markdown e o CommonMark organizaram as imagens ![]() e os links de referência, mas envolver a URL entre parênteses se manteve constante. Uma peculiaridade antiga é que uma URL que contém os próprios parênteses — pense numa página de desambiguação da Wikipédia — pode confundir um analisador ingênuo, que para no primeiro parêntese de fechamento que encontra. É um caso limite clássico dos processadores de Markdown, então, na hora de extrair links, vale a pena reler os resultados em busca de URLs que carregam os próprios parênteses.