Sintaxe Markdown: guia rápido

Toda a sintaxe Markdown em uma página — o básico da especificação original, as extensões GitHub-Flavored e os extras usados em documentação moderna. Copie qualquer exemplo no editor para vê-lo renderizado ao vivo.

Testar no editor

Grátis · sem cadastro · roda no seu navegador, nada é enviado

Markdown Viewer em layout dividido: código Markdown à esquerda, prévia renderizada no estilo GitHub à direita — Layout dividido — o código e a prévia renderizada lado a lado, rolando em sincronia linha por linha.

Sintaxe básica

Markdown	Resultado	Observações
`# Título 1`	Título 1	Até seis níveis: `######`
`## Título 2`	Título 2	Um espaço depois de `#` é obrigatório
`negrito`	negrito	ou `__negrito__`
`itálico`	itálico	ou `_itálico_`
`*negrito itálico*`	*negrito itálico*
`~~tachado~~`	~~tachado~~	GFM
`código inline`	`código inline`	Use duas crases para incluir uma crase
`> citação`	citação	Aninhe com `> >`
`---`		Linha horizontal; `***` também
`linha um\`	quebra de linha	Uma barra invertida no fim ou dois espaços forçam um `<br>`
`\sem itálico\`	sem itálico	A barra invertida escapa qualquer pontuação

Links e imagens

Markdown	Resultado	Observações
`[texto](https://example.com)`	texto	Link inline
`[texto](https://example.com "Título")`	texto	Título opcional, aparece ao passar o mouse
`<https://example.com>`	https://example.com	Link automático; URLs soltas também viram link no GFM
`[texto][ref] … [ref]: https://example.com`	texto	Link por referência, definido em qualquer lugar
`[Título 2](#título-2)`	Título 2	Âncora: minúsculas, espaços → hifens
`![texto alternativo](image.png)`	uma imagem	Adicione `"Título"` depois da URL para uma dica
`[![alt](img.png)](https://link)`	uma imagem clicável	Imagem dentro de um link

Listas

Markdown	Resultado	Observações
`- item - item`	item item	`*` e `+` também funcionam
`1. primeiro 2. segundo`	primeiro segundo	Os números não precisam ser sequenciais
`- item - aninhado`	item aninhado	Recue 2–4 espaços para aninhar
`- [ ] a fazer - [x] feito`	☐ a fazer ☑ feito	Lista de tarefas (GFM)
`1. passo parágrafo`	um item de lista com dois parágrafos	Recue as linhas de continuação até o texto

Coloque uma linha em branco antes de uma lista que vem depois de um parágrafo, senão alguns renderizadores a tratam como parte do parágrafo.

Tabelas

| Esquerda | Centro | Direita |
| :--- | :----: | ----: |
| a    |   b    |     c |

Esquerda	Centro	Direita
a	b	c

A linha separadora define o alinhamento com dois-pontos. As células podem conter formatação inline, links e código; use \| para uma barra vertical literal. As barras externas são opcionais.

Blocos de código

```javascript
const answer = 42;
```

Três crases (ou tis) abrem e fecham um bloco cercado; a palavra depois da cerca de abertura define a linguagem para o realce de sintaxe — js, python, bash, json, yaml, diff, sql e mais de 50 outras. Recuar um bloco com quatro espaços também cria um bloco de código, mas as cercas são mais claras e permitem indicar uma linguagem. Para mostrar crases dentro de um bloco, use uma cerca mais longa (quatro crases).

Extras do GitHub-Flavored

Markdown	Resultado	Observações
`> [!NOTE]`	destaque ⓘ Note	Também `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
`texto[^1] … [^1]: A nota.`	texto¹ com a nota no fim	Notas de rodapé
`:rocket: :sparkles:`	🚀 ✨	Códigos de emoji
`<details><summary>Mais</summary>…</details>`	uma seção recolhível	HTML inline; deixe uma linha em branco antes do Markdown interno
`<kbd>Ctrl</kbd>+<kbd>C</kbd>`	`Ctrl`+`C`	Teclas do teclado
`[[toc]]`	um sumário	Gerado a partir dos títulos (este visualizador)
`--- title: Doc ---`	front matter	Metadados YAML bem no início do arquivo

Fórmulas e diagramas

Markdown	Resultado	Observações
$E = mc^2$	fórmula inline	Sintaxe KaTeX / LaTeX
`$$ \int_0^1 x^2\,dx $$`	uma fórmula centralizada em modo de exibição	Em linhas próprias
```mermaid flowchart LR A --> B ```	um fluxograma	Mermaid: flowchart, sequence, class, state, gantt, pie…

Fórmulas e Mermaid não fazem parte do padrão Markdown, mas este visualizador, o GitHub (Mermaid e fórmulas), Obsidian, Typora e a maioria das ferramentas de documentação os suportam. Todos os tipos de diagrama Mermaid que este visualizador desenha estão listados na página do editor Mermaid online.

Veja em ação

Alertas Note, Important, Warning e Caution no estilo GitHub, uma citação e uma seção details recolhível no tema GitHub Dark — Alertas no estilo GitHub, citações e seções <details> recolhíveis, em GitHub Dark.

Fórmula KaTeX em modo de exibição e um fluxograma Mermaid renderizados dentro da prévia — Fórmulas KaTeX e fluxogramas Mermaid são renderizados direto no documento.

Blocos de código TypeScript, Python, Bash e diff com realce de sintaxe, rótulos de linguagem e botões de copiar — Os blocos de código ganham rótulo de linguagem, realce de sintaxe para mais de 50 linguagens e botão de copiar — este é o tema One Dark.

Perguntas frequentes

O que é Markdown?

Uma linguagem de marcação leve criada por John Gruber em 2004. Símbolos de texto puro como # e ** descrevem a formatação, e um renderizador transforma o texto em HTML. É usada em READMEs, documentação, notas, mensagens de chat e respostas de assistentes de IA.

O que é GitHub-Flavored Markdown (GFM)?

A extensão do GitHub para a especificação CommonMark, que adiciona tabelas, listas de tarefas, tachado, links automáticos e alertas. É o padrão de fato para documentação de desenvolvedores e o que este visualizador renderiza.

Como faço uma quebra de linha sem um novo parágrafo?

Termine a linha com uma barra invertida ou com dois espaços. Uma linha em branco, por outro lado, começa um novo parágrafo.

Como escapo caracteres especiais?

Coloque uma barra invertida na frente: \* \_ \# \` \| \[ \]. Dentro de trechos e blocos de código nada precisa ser escapado.

Como adiciono um sumário?

Escreva [[toc]] em uma linha própria neste visualizador, ou linke os títulos manualmente com [Seção](#nome-da-secao).

Posso testar esses exemplos?

Sim — abra o editor, cole qualquer exemplo e veja a prévia ao vivo. O documento de exemplo também demonstra toda a sintaxe desta página.

Ferramentas relacionadas

Pronto quando você estiver

Cole Markdown, solte um arquivo ou abra uma URL — a prévia aparece na hora e tudo fica no seu dispositivo.

Abrir o Markdown Viewer