title: Visão geral da sintaxe básica do Markdown description: Panorama dos elementos básicos, princípios e boas práticas do Markdown — ideal para iniciar rapidamente.
Sintaxe básica do Markdown
Markdown é uma linguagem de marcação leve, com sintaxe simples, que permite focar no conteúdo em vez da formatação. Usa texto simples, fácil de ler e escrever; pode ser misturada com HTML e exportada para HTML, PDF e para o próprio formato .md.
Filosofia de design
O objetivo do Markdown é ser “fácil de ler e escrever”.
A legibilidade é sempre o mais importante. Um documento em Markdown deve poder ser publicado diretamente como texto simples sem parecer cheio de tags ou instruções de formatação.
O principal objetivo da sintaxe do Markdown é ser o mais legível possível. Com base nisso, documentos em Markdown podem ser publicados como texto puro sem parecerem repletos de marcas ou instruções.
—— John Gruber
Compatibilidade com HTML
O propósito do Markdown é ser uma linguagem de escrita para a web.
Markdown não pretende substituir o HTML, nem ser muito semelhante a ele; a sua sintaxe é pequena e cobre apenas uma parte das marcações HTML.
Tags fora do escopo do Markdown podem ser usadas diretamente como HTML no documento. Não é necessário indicar se é HTML ou Markdown; basta inserir as tags.
Por exemplo, adicionar uma tabela HTML num ficheiro Markdown:
Este é um parágrafo normal.
<table>
<tr>
<td>Foo</td>
</tr>
</table>
Este é outro parágrafo normal.Conversão automática de caracteres especiais
Em HTML, dois caracteres exigem tratamento especial: < e &.
<inicia tags&introduz entidades HTML
Com Markdown, escreves naturalmente e o processador trata das conversões. Se & fizer parte de uma entidade HTML, mantém‑se; caso contrário, é convertido para &.
Elementos básicos de sintaxe
A sintaxe básica do Markdown inclui:
Elementos de bloco
- Títulos - criar níveis com
# - Parágrafos e quebras - regras de parágrafos e quebras de linha
- Citações - criar blockquotes com
> - Listas - listas ordenadas e não ordenadas
- Blocos de código - formato especial para código
- Linhas horizontais - criar separadores
Elementos inline
- Ênfase - negrito e itálico
- Ligações - criar hyperlinks
- Imagens - inserir imagens
- Código inline - marcação inline
Outros
- Escape de caracteres - escapar caracteres especiais
- Auto‑links - reconhecimento automático de links
Exemplo de sintaxe
Segue um exemplo que reúne vários elementos básicos:
# O meu documento
Este é um exemplo de **texto em negrito** e *texto em itálico*.
## Exemplo de listas
### Lista de compras
- maçãs
- bananas
- laranjas
### Lista de tarefas
1. Estudar a sintaxe básica do Markdown
2. Praticar a escrita
3. Partilhar com amigos
> Este é um exemplo de bloco de citação. O Markdown torna a escrita simples e elegante.
Este é um [link para a página inicial](/pt/).
Exemplo de código:Também podes usar código inline, por exemplo console.log('Hello World').
Boas práticas
Títulos
- Usa apenas um H1 (
#) por documento - Mantém hierarquia lógica, sem saltar níveis
- Deixa linhas em branco antes/depois do título
Listas
- Mantém consistência nos marcadores das listas não ordenadas (
-,*ou+) - Não precisas de linha em branco entre itens, exceto com múltiplos parágrafos
Ligações e imagens
- Fornece texto descritivo para links
- Usa texto alternativo (alt) para imagens
Código
- Usa código inline para trechos curtos
- Usa blocos de código para trechos longos ou multi‑linha
- Define a linguagem para destacar a sintaxe
Suporte de ferramentas
Praticamente todas as aplicações Markdown suportam estes elementos básicos. Podem existir pequenas diferenças entre processadores, mas a base é comum.
Próximos passos
Agora que tens uma visão geral da sintaxe básica do Markdown, podes:
- Aprofundar o uso de cada elemento
- Consultar a folha de referência para um resumo rápido
- Aprender a sintaxe estendida para mais funcionalidades
- Explorar uso avançado e boas práticas
Começa pelos elementos específicos: