Sintaxe estendida do Markdown

A sintaxe básica do Markdown cobre o essencial, mas pode ser insuficiente para necessidades específicas. É aqui que entram as extensões.

As extensões adicionam funcionalidades à sintaxe básica para criar documentos mais ricos e complexos.

O que é sintaxe estendida?

São elementos além da especificação original do Markdown, adicionados por diferentes processadores para recursos extra.

Extensões comuns

• Tabelas — criar tabelas de dados
• Blocos de código cercados — com realce de sintaxe
• Notas de rodapé — referências e notas
• IDs de títulos — IDs personalizados para âncoras
• Listas de definições — termos e definições
• Tachado — riscar texto
• Listas de tarefas — checklists
• Emoji — símbolos
• Destaque — realçar texto
• Subscrito e sobrescrito — comum em fórmulas

Suporte

Nem todos os apps de Markdown suportam extensões. Confirma o suporte do teu processador antes de usar.

Suporte em destaque

Plataformas e ferramentas com bom suporte:

• GitHub Flavored Markdown (GFM) — extensão do GitHub
• GitLab Flavored Markdown — extensão do GitLab
• Typora — editor Markdown WYSIWYG
• Obsidian — gestão de conhecimento
• VitePress — gerador de sites estáticos
• Hugo — gerador de sites estáticos

Tabelas

Uma das extensões mais usadas:

| Nome | Idade | Profissão |
|------|------|------|
| Zhang | 25   | Engenheiro |
| Li    | 30   | Designer   |

Nome	Idade	Profissão
Zhang	25	Engenheiro
Li	30	Designer

Blocos de código cercados

Código com realce de sintaxe:

```javascript
function hello() {
    console.log("Hello, World!");
}
```

function hello() {
    console.log("Hello, World!");
}

Listas de tarefas

Criar uma checklist:

- [x] Concluir plano do projeto
- [ ] Escrever código
- [ ] Testar funcionalidades
- [ ] Fazer deploy

• [x] Concluir plano do projeto
• [ ] Escrever código
• [ ] Testar funcionalidades
• [ ] Fazer deploy

Tachado

Para marcar conteúdo removido/incorreto:

~~este texto está riscado~~

这段文字有删除线

Auto‑links

Reconhecer automaticamente URL e e‑mail:

Visita https://markdown.com.cn para saber mais.
E‑mail: example@domain.com

Visita https://markdown.com.cn para saber mais. E‑mail: example@domain.com

Notas de rodapé

Adicionar notas e referências:

Aqui vai um exemplo de nota[^1].

[^1]: Este é o conteúdo da nota.

Aqui vai um exemplo de nota[^1].

[^1]: Este é o conteúdo da nota.

Listas de definições

Lista de termos e definições:

Markdown
:   Uma linguagem de marcação leve

HTML
:   Linguagem de Marcação de Hipertexto
:   Padrão para criar páginas web

Fórmulas matemáticas

Suporte a fórmulas estilo LaTeX:

Fórmula inline: $E = mc^2$

Fórmula em bloco:
$$
\sum_{i=1}^n a_i = 0
$$

Diagramas e fluxogramas

Alguns editores suportam Mermaid:

```mermaid
graph TD
    A[开始] --> B{是否理解?}
    B -->|是| C[继续学习]
    B -->|否| D[重新阅读]
    D --> B
    C --> E[结束]
```

Roteiro de estudo da sintaxe estendida

Sugerimos a seguinte ordem:

1. Tabelas — muito usado e prático
2. Blocos de código cercados — essencial para programadores
3. Listas de tarefas — ótimo em gestão de projetos
4. Tachado — simples e útil
5. Notas de rodapé — preciso em escrita académica
6. Listas de definições — para termos
7. IDs de títulos — âncoras avançadas
8. Destaque — ênfase

Notas de compatibilidade

Ao usar sintaxe estendida:

• Testar compatibilidade — testa no alvo
• Plano B — considera a visualização sem extensão
• Documentar — indica quais extensões foram usadas
• Normalização — adota um padrão na equipa

Próximos passos

Escolhe por onde começar:

• Guia de tabelas
• Sintaxe de blocos de código
• Lista completa de extensões