title: Sintaxe de ligações no Markdown description: Hiperligações, referências, auto‑links e resolução de erros comuns em Markdown.

Sintaxe de ligações

As ligações são essenciais para conectar conteúdos em Markdown. Dominar as variantes torna o documento mais navegável e útil.

Sintaxe básica

Ligações inline

Cria uma ligação com [texto](URL):

Este é um link para o [Google](https://www.google.com).
Visita o [GitHub](https://github.com) para ver projetos open‑source.

Resultado:

Este é um link para o Google. Visita o GitHub para ver projetos open‑source.

Ligação com título

Adiciona um título após a URL (apresentado ao pairar):

Este é um [link com título](https://www.example.com "Este é o título do link").

Resultado:

Este é um link com título.

Ligações por referência

Básico

Separa uso e definição:

Este é um [link por referência][1].
Este é outro [link por referência][link-name].

[1]: https://www.example.com
[link-name]: https://www.google.com "Pesquisa Google"

Resultado:

Este é um link por referência. Este é outro link por referência.

Rótulos implícitos

O próprio texto serve de rótulo:

Visita [Google][] para pesquisar.
Vê projetos em [GitHub][].

[Google]: https://www.google.com
[GitHub]: https://github.com

Resultado:

Visita Google para pesquisar. Vê projetos em GitHub.

Auto‑links

URL

Escreve a URL entre < >:

<https://www.example.com>
<https://github.com/user/repo>

Resultado:

https://www.example.comhttps://github.com/user/repo

Email

Contacta‑me: <user@example.com>
Suporte técnico: <support@company.com>

Resultado:

Contacta‑me: user@example.com Suporte técnico: support@company.com

Ligações internas

Âncoras

Aponta para títulos na mesma página:

Ir para [Sintaxe básica](#sintaxe-básica)
Ver [Boas práticas](#boas-práticas)

Resultado:

Ir para Sintaxe básica Ver Boas práticas

Caminhos relativos

Aponta para outros ficheiros:

Ver [Cabeçalhos](headings.md)
Voltar à [inicial](../index.md)

Ligações especiais

Imagem com link

Envolver imagem numa ligação:

[![texto alternativo](image.png)](https://www.example.com)

Download

Aponta para ficheiros para download:

Transferir [Manual do utilizador](files/manual.pdf)
Obter [Exemplos de código](examples/demo.zip)

Formatação do texto da ligação

Texto formatado

Isto é um [**link em negrito**](https://www.example.com)
Isto é um [*link em itálico*](https://www.example.com)
Isto é um [`link em estilo de código`](https://www.example.com)

Resultado:

Isto é um link em negrito Isto é um link em itálico Isto é um link em estilo de código

Texto de múltiplas linhas

Isto é um [texto de ligação muito longo,
pode quebrar a linha](https://www.example.com)

Erros comuns e soluções

1) Parênteses incoerentes

❌ Incorreto:
[texto(https://www.example.com)  ← falta )

✅ Correto:
[texto](https://www.example.com)

2) Espaços

❌ Incorreto:
[ texto ]( https://www.example.com )  ← espaços desnecessários

✅ Correto:
[texto](https://www.example.com)

3) Codificação de URL

Para URLs com caracteres especiais:

❌ Pode falhar:
[Pesquisa](https://www.google.com/search?q=markdown)

✅ Mais seguro:
[Pesquisa](https://www.google.com/search?q=markdown)
Ou usa referências:
[Pesquisa][google-search]

[google-search]: https://www.google.com/search?q=markdown

Boas práticas

1) Usa texto descritivo

✅ Recomenda‑se: texto descritivo
Consulta a [documentação oficial do Markdown](https://daringfireball.net/projects/markdown/syntax)

❌ Evitar: texto genérico
Clica [aqui](https://daringfireball.net/projects/markdown/syntax) para ver

2) Usa referências em docs longos

✅ Recomenda‑se: referências em docs longos
No nosso estudo, referimos [Smith et al.][smith2020],
[a teoria de Jones][jones2019] e [o relatório mais recente][industry2021].

[smith2020]: https://www.markdownlang.com/smith-2020-paper
[jones2019]: https://www.markdownlang.com/jones-theory
[industry2021]: https://www.markdownlang.com/industry-report-2021

3) Mantém URLs simples

✅ Recomenda‑se: URL curta ou domínio próprio
[Página do projeto](https://myproject.com)

✅ Aceitável: usar referência para URL longa
Ver o nosso [relatório detalhado][detailed-report]

[detailed-report]: https://company.com/reports/2023/detailed-analysis-q4-performance-metrics

Verificação de ligações

Validar ligações

Verifica regularmente os links:

<!-- Dica: anotar estado do link -->
[Active Link](https://www.google.com) <!-- ✓ 2023-01-15 -->
[Deprecated Link](https://old-site.com) <!-- ⚠️ pode estar indisponível -->

Ferramentas

• linkchecker — CLI para verificar links
• markdown-link-check — verificação em Node.js
• Extensão VS Code — validação em tempo real

Saída HTML

Conversão para HTML:

[texto do link](https://www.example.com "título")

Converte para:

<a href="https://www.example.com" title="título">texto do link</a>

Técnicas avançadas

1) Ligações condicionais

Adiciona links conforme o contexto:

Em ambiente de desenvolvimento, acede ao [servidor local](http://localhost:3000)
Em produção, acede ao [servidor online](https://production.example.com)

2) Grupos de ligações

Agrupa links relacionados:

<!-- Recursos oficiais -->
[Site oficial][official]
[Documentação oficial][docs]
[Blog oficial][blog]

<!-- Recursos da comunidade -->
[Repositório GitHub][github]
[Discussões no fórum][forum]
[Blog da comunidade][community]

[official]: https://www.markdownlang.com
[docs]: https://docs.example.com
[blog]: https://blog.example.com
[github]: https://github.com/example/project
[forum]: https://forum.example.com
[community]: https://community.example.com

3) Ligações multilíngua

Ver docs: [English](README.md) | [中文](README-zh.md) | [日本語](README-ja.md)

Exemplos práticos

Menu de navegação

## Navegação rápida

**Guia de início**
- [O que é Markdown](what-is-markdown.md)
- [Instalar editor](install-editor.md)
- [Primeiro documento](first-document.md)

**Referência de sintaxe**
- [Sintaxe básica](basic-syntax.md)
- [Sintaxe estendida](extended-syntax.md)
- [Boas práticas](best-practices.md)

**Recursos**
- [Site oficial](https://daringfireball.net/projects/markdown/)
- [Editor online](https://dillinger.io/)
- [Lint de Markdown](https://markdownlint.github.io/)

Referências

## Referências

Este documento baseia‑se nos seguintes recursos:

1. [Sintaxe oficial do Markdown][markdown-syntax] - John Gruber
2. [Especificação CommonMark][commonmark] — normalização
3. [GitHub Flavored Markdown][gfm] — extensões do GitHub
4. [Markdown Guide][markdown-guide] — guia completo

[markdown-syntax]: https://daringfireball.net/projects/markdown/syntax
[commonmark]: https://commonmark.org/
[gfm]: https://github.github.com/gfm/
[markdown-guide]: https://www.markdownguide.org/

Ferramentas recomendadas

## Ferramentas

### Editores
- [Typora](https://typora.io/) — WYSIWYG
- [Mark Text](https://marktext.app/) — open‑source
- [VS Code](https://code.visualstudio.com/) + extensões de Markdown

### Ferramentas online
- [Dillinger](https://dillinger.io/) — editor online
- [StackEdit](https://stackedit.io/) — editor rico
- [Markdown to HTML](https://markdowntohtml.com/) — conversão

### Geradores de sites estáticos
- [VitePress](https://vitepress.dev/) — Vue
- [Docusaurus](https://docusaurus.io/) — React
- [GitBook](https://gitbook.com/) — plataforma de docs

Sintaxe relacionada

• Imagens — inserir imagens
• Citações — blockquote
• Código — formatação
• Auto‑links — links automáticos

Exercícios

Tenta criar:

1. Uma lista de recursos com links externos
2. Um documento técnico com referências
3. Um documento longo com navegação interna
4. Uma página de contacto com email e website