Sintaxe Markdown com exemplos práticos

Encontre a sintaxe, copie um exemplo e compare código e resultado. As seções diferenciam a base portátil do CommonMark de extensões comuns do GFM; o destino ainda precisa ser conferido.

Testar no editor

Markdown em poucas palavras

Markdown usa sinais simples para descrever estrutura: # para títulos, asteriscos para ênfase, hífens para listas e colchetes com parênteses para links. Tabelas, listas de tarefas e tachado são extensões comuns do GFM e podem variar entre plataformas.

01

Como usar Referência rápida do Markdown

Trabalhe primeiro com uma dúvida de sintaxe ou um exemplo; só considere a tarefa concluída depois de conferir exemplos Markdown copiáveis.

  1. 1Adicionar a origemDigite, cole ou abra uma dúvida de sintaxe ou um exemplo. O conteúdo continua disponível para correção durante a tarefa.
  2. 2Revisar a estruturaRevise a estrutura principal, confira os elementos que devem permanecer e corrija o que não fizer sentido antes de gerar o resultado.
  3. 3Consultar a sintaxeUse a ação “Consultar a sintaxe” e verifique exemplos Markdown copiáveis no programa ou no destino em que será usado.
Títulos

Criar títulos com #

Use de um a seis sinais #, seguidos de espaço. Mantenha um único H1 por documento quando a plataforma tratar H1 como título principal.

# Título principal
## Seção
### Subseção

Resultado: Três níveis de título

  • Inclua espaço depois de #
  • Não pule níveis sem necessidade
Texto

Separar parágrafos

Deixe uma linha em branco entre blocos de texto.

Primeiro parágrafo.

Segundo parágrafo.

Resultado: Dois parágrafos

  • Uma quebra simples pode virar espaço
  • Use linha em branco para prosa
Ênfase

Negrito, itálico e tachado

Asteriscos ou sublinhados marcam ênfase. O tachado com ~~ é uma extensão comum do GFM.

**negrito**
*itálico*
~~tachado~~

Resultado: Texto com três tipos de ênfase

  • Não deixe espaço dentro dos marcadores
  • Confirme extensões no destino
Listas

Lista com marcadores

Use hífen, asterisco ou sinal de mais seguido de espaço.

- Primeiro
- Segundo
  - Aninhado

Resultado: Lista com subitem

  • Mantenha o marcador consistente
  • Recuo controla o aninhamento
Listas

Lista numerada

Use número, ponto e espaço. Muitos renderizadores recalculam a numeração.

1. Preparar
2. Revisar
3. Publicar

Resultado: Lista ordenada com três itens

  • Não omita o espaço
  • Teste listas aninhadas
Imagens

Inserir imagem e texto alternativo

Adicione ! antes da sintaxe de link. O texto entre colchetes descreve a imagem.

![Diagrama do fluxo](https://example.com/fluxo.png)

Resultado: Imagem com texto alternativo

  • Prefira descrição útil
  • Confira permissões e disponibilidade da URL
Citações

Criar citação em bloco

Comece cada linha do bloco com >. Acrescente outro > para aninhar.

> Uma observação importante.
>
> Segundo parágrafo.

Resultado: Citação com dois parágrafos

  • Use > também na linha vazia
  • Não confunda citação com crédito
Código

Código em linha

Use crases para nomes de comando, arquivo ou trecho curto.

Execute `npm run build`.

Resultado: Comando em fonte de código

  • Não use para ênfase comum
  • Para crase literal, use delimitador maior
Código

Bloco de código cercado

Use três crases antes e depois. Um identificador de linguagem pode ativar realce.

```js
const ok = true;
```

Resultado: Bloco de código JavaScript

  • Feche o bloco
  • Não altere o conteúdo literal
Tabelas

Criar tabela Markdown

A primeira linha traz os cabeçalhos, a segunda usa hífens e as demais trazem os dados. A tabela é uma extensão comum do GFM.

| Ferramenta | Uso |
| --- | --- |
| Editor | Escrever |
| Conversor | Exportar |

Resultado: Tabela de duas colunas

  • Mantenha a mesma quantidade de células
  • Escape uma barra vertical literal como \|
Criar uma tabela Markdown
GFM

Lista de tarefas

Use [ ] para pendente e [x] para concluído depois do marcador.

- [x] Escrever
- [ ] Revisar

Resultado: Uma tarefa concluída e outra pendente

  • Inclua espaço depois do colchete
  • Interatividade depende da plataforma
Separadores

Linha horizontal

Use três ou mais hífens, asteriscos ou sublinhados em uma linha isolada.

Texto acima

---

Texto abaixo

Resultado: Texto separado por uma linha

  • Deixe linhas em branco ao redor
  • Evite confundir com título Setext
Quebras

Quebra de linha explícita

Dois espaços no fim criam uma quebra em CommonMark; uma barra invertida também pode funcionar em destinos compatíveis.

Primeira linha  
segunda linha

Resultado: Duas linhas no mesmo parágrafo

  • Mostre espaços invisíveis no editor
  • Teste no destino final
Caracteres

Escapar símbolos

Use barra invertida antes de um símbolo que não deve ser interpretado como sintaxe.

\*isto não é itálico\*

Resultado: Asteriscos visíveis

  • Escape só quando necessário
  • Regras variam dentro de código
Extensões

Notas de rodapé

Alguns renderizadores aceitam referência [^1] e definição correspondente; CommonMark básico não exige esse recurso.

Texto com nota.[^1]

[^1]: Detalhe da nota.

Resultado: Referência e nota de rodapé

  • Confirme suporte no destino
  • Use identificadores únicos
Avançado

HTML dentro do Markdown

Algumas plataformas aceitam HTML embutido; outras removem ou escapam as tags.

<details><summary>Detalhes</summary>Texto</details>

Resultado: Bloco expansível somente onde houver suporte

  • Evite depender de HTML para portabilidade
  • Nunca inclua código não confiável
Compatibilidade

CommonMark e GitHub Flavored Markdown

A sintaxe básica é amplamente aceita, mas extensões não são universais. Confira o editor, CMS ou repositório em que o conteúdo será publicado.

Base / CommonMark

Títulos, parágrafos, ênfase, citações, listas, código, links, imagens e linhas horizontais formam a base portátil.

Extensões GFM

Tabelas, tarefas, tachado e autolinks ampliados dependem do renderizador.

Consulte as especificações: CommonMark · GFM

Continue trabalhando

Conversores, ferramentas Markdown e guias relacionados

Conversores mais usados

Converter Markdown em HTMLConverta Markdown em HTML semântico, copie o código ou baixe um arquivo .html com títulos, listas, links, tabelas e blocos de código.Converter Markdown em PDF com texto pesquisávelCrie um PDF A4 com texto pesquisável e selecionável a partir de Markdown. Confira títulos, listas, tabelas, código, links e quebras de página.Converter Markdown em Word e baixar DOCXTransforme Markdown em um DOCX editável com títulos, listas, tabelas, links, citações e blocos de código para Word, Google Docs ou Pages.Remover a formatação Markdown e obter texto simplesRemova títulos, asteriscos, cercas e outros sinais de formatação para obter texto simples legível, pronto para copiar ou baixar como .txt.
Mais conversores (26)
Salvar Markdown como imagem PNGRenderize Markdown em uma imagem PNG sem marca d’água. Confira dimensões, fundo, texto, tabelas, código e altura antes de compartilhar.Salvar Markdown como imagem JPGTransforme Markdown em uma imagem JPG compacta e sem marca d’água. Confira nitidez, compressão, texto e altura no arquivo baixado.Converter Markdown em arquivo RTF editávelCrie um arquivo RTF a partir de Markdown para abrir no Word, TextEdit ou LibreOffice. Confira títulos, listas, tabelas, código e acentos.Transformar Markdown em uma árvore JSONAnalise o Markdown como uma árvore sintática JSON com tipos, conteúdo e hierarquia para desenvolvimento, testes e depuração.Converter tabela Markdown em CSVExtraia linhas e colunas de uma tabela Markdown e baixe CSV para Excel, Google Sheets ou outro sistema tabular.Converter tabela Markdown para ExcelCrie uma pasta de trabalho XLSX editável a partir de tabelas Markdown. Confira abas, valores, tipos e caracteres especiais.Converter Markdown em AsciiDocMigre títulos, listas, links, código e tabelas simples para uma fonte AsciiDoc editável e revise o resultado no Asciidoctor ou Antora.Converter Markdown em reStructuredTextTransforme Markdown em RST para Sphinx e docutils. Revise títulos, recuos, tabelas, código, funções e diretivas do projeto.Converter Markdown em Confluence Wiki MarkupGere Wiki Markup legado para fluxos compatíveis do Confluence Data Center. Não publica na nuvem nem acessa sua conta.Preparar um arquivo Markdown para o NotionNormalize e baixe um arquivo .md para importar no Notion. A ferramenta não acessa sua conta nem sincroniza páginas por API.Converter Markdown em código LaTeXTransforme a estrutura comum de Markdown em LaTeX editável. Revise matemática, citações, bibliografia, pacotes e o arquivo compilado.Converter Markdown em ebook EPUBCrie um EPUB refluível a partir de Markdown e confira título, idioma, capítulos, sumário, XHTML e leitura no aplicativo final.Criar um mapa mental a partir de MarkdownTransforme a hierarquia de títulos Markdown em um mapa mental interativo e exporte SVG. Revise estrutura, rótulos e imagens externas.Criar slides Reveal.js a partir de MarkdownTransforme seções Markdown em uma apresentação HTML Reveal.js. Confira separação, código, tabelas, imagens e dependência de CDN.Transformar Markdown em um card de imagemCrie um card PNG sem marca d’água usando o primeiro título como chamada e o conteúdo curto como corpo. Confira texto e limites.Converter Markdown em PowerPoint editávelCrie uma apresentação PPTX editável a partir de títulos, listas e separadores Markdown. Revise cada slide no PowerPoint.Preparar um artigo Markdown para WeChatConverta Markdown em conteúdo rico para colar no editor de WeChat Official Account. Confira estilos, imagens, links, tabelas e código.Converter HTML em Markdown editávelTransforme HTML em Markdown com títulos, parágrafos, links, listas, código e tabelas simples. Edite e confira a prévia antes de baixar.Converter CSV em tabela MarkdownTransforme linhas CSV em uma tabela Markdown editável, confira cabeçalho, aspas, separador e células vazias, depois copie ou baixe .md.Converter um documento Word em MarkdownAbra um DOCX e recupere títulos, parágrafos, listas, links e tabelas como Markdown editável. Confira perdas de layout e mídia.Converter planilhas Excel em tabelas MarkdownAbra uma pasta XLSX e transforme abas não vazias em seções e tabelas Markdown editáveis. Confira nomes, valores e ordem.Converter PPTX em Markdown editávelExtraia títulos e texto de slides PowerPoint na ordem da apresentação. Edite, confira a prévia e baixe o resultado como .md.Converter JSON em tabelas, listas e MarkdownTransforme objetos e arrays JSON em Markdown legível. Arrays de objetos podem virar tabelas; dados aninhados viram seções e listas.Converter XML em uma estrutura Markdown legívelTransforme elementos, atributos e texto XML em títulos, listas e blocos Markdown. XML inválido permanece visível para correção.Organizar texto simples como MarkdownNormalize listas, numeração, espaços e parágrafos de um texto simples e continue editando títulos, links e ênfase manualmente.Converter PDF de texto ou escaneado em MarkdownExtraia a camada de texto de um PDF ou use OCR local em idiomas compatíveis. Edite o Markdown, confira a prévia e baixe .md.

Ferramentas Markdown

Editor MarkdownEscreva e revise Markdown com uma prévia renderizada.Prévia de MarkdownAbra um arquivo MD e confira o resultado renderizado.Gerador de tabelasCrie uma tabela ou importe CSV e TSV.Formatador MarkdownNormalize espaços, listas e a estrutura do Markdown.Aprender MarkdownPratique com 24 exercícios interativos.

Guias práticos

O que é um arquivo MD e como abrirEntenda o que é um arquivo .md, como abrir no Windows, macOS, celular ou navegador, editar com segurança e converter para outro formato.Como fazer quebra de linha no MarkdownAprenda a criar parágrafo, quebra de linha e nova linha no Markdown, com exemplos, diferenças entre renderizadores e passos para corrigir falhas.Como converter Markdown em PDF e conferir o arquivoConverta Markdown em PDF de texto, revise títulos, tabelas, código, imagens e paginação e evite um arquivo vazio ou cortado.Como converter HTML em MarkdownTransforme HTML em Markdown editável, preserve a estrutura útil e revise tabelas, links, imagens, código e elementos sem equivalente.Como converter Markdown em WordTransforme Markdown em DOCX editável e confira títulos, listas, tabelas, links, código, imagens e recursos sem equivalente direto.Como remover um bloco externo de código de um documento MarkdownRemova quatro crases que envolvem um documento Markdown e preserve blocos de código internos com uma verificação segura.Por que o ChatGPT mostra Markdown nas respostas?Entenda por que respostas do ChatGPT podem conter títulos, listas, links, tabelas e blocos de código em Markdown e como copiar ou limpar o texto.

Perguntas sobre a sintaxe Markdown

O que é mantido em exemplos Markdown copiáveis?

Cada módulo mostra código e resultado esperado. Tabelas, tarefas e tachado são marcados como extensões. Notas de compatibilidade evitam prometer um único dialeto. Ainda assim, confira o resultado no destino final.

Por que exemplos Markdown copiáveis pode ficar diferente da origem?

Os formatos não têm os mesmos recursos. A referência não cobre todas as extensões de cada plataforma. Tabelas e tarefas não pertencem ao núcleo CommonMark.

Como revisar exemplos Markdown copiáveis antes de usar?

Teste HTML incorporado e regras específicas no destino. Guarde a origem até terminar essa comparação.