Markdown completo: cheatsheet 2026 + guia para iniciantes

Por que Markdown ganhou em vez de WYSIWYG?

Editores WYSIWYG (Word, Google Docs) têm vantagem visual mas SUMEM a estrutura semântica. Você não consegue versionar bem (binário no Word, JSON no Google Docs), automatizar (Word não tem CLI), ou copiar entre sistemas (formatação quebra entre Word e Notion).

Markdown é texto puro com sintaxe simples. Você versiona em Git com diff legível, copia entre qualquer ferramenta moderna (todas suportam), automatiza com scripts, e o source é human-readable mesmo cru.

Sintaxe básica (CommonMark) — 90% do uso diário

Headings: use `#` para H1, `##` para H2, até `######` para H6. Sempre espaço após `#`.

Bold: `texto` vira texto. Italic: `texto` vira texto. Bold+italic: `*texto*`.

Links: `texto` vira texto.

Imagens: `!alt text` — adiciona alt text para acessibilidade e SEO.

Código inline: use crase: \`código\` vira `código`.

Blockquote: linha começando com `>` vira citação.

Listas: ordenadas e não-ordenadas

Lista não-ordenada (use `-`, `*` ou `+`):

``` - Item 1 - Item 2 - Item aninhado (indent 2 espaços) - Item 3 ```

Lista ordenada (use números — não importa se sequenciais):

``` 1. Primeiro 2. Segundo 3. Terceiro ```

Tip pro: use `1.` em todos os items — Markdown renumera automaticamente. Facilita reordenar sem renumerar à mão.

Code blocks: linguagem com syntax highlight

Para blocos de código, use 3 crases (\`\`\`) antes e depois. Adicione o nome da linguagem após as crases iniciais para syntax highlighting:

```javascript const hello = (name) => `Hello, ${name}!`; console.log(hello('World')); ```

Linguagens suportadas em GFM: javascript, typescript, python, rust, go, java, ruby, php, swift, kotlin, html, css, sql, bash, yaml, json, markdown, plaintext, e muitas outras.

GFM (GitHub Flavored Markdown) — extensões essenciais

GitHub adicionou recursos que viraram padrão de fato:

• Tabelas: pipe `|` separa colunas, traços `---` marcam header. Use o Gerador de Tabela Markdown para tabelas complexas.
• Task lists (checkboxes): `- [ ] não feito` e `- [x] feito`. Renderiza como checkbox interativo.
• Strikethrough: `~~texto~~` vira ~~texto~~ (texto riscado).
• Autolinks: URLs viram links automaticamente sem precisar `text`.
• Footnotes: `[^1]` no texto + `[^1]: explicação` no fim.
• Emoji shortcodes: `:rocket:` vira 🚀 (suporte varia por renderer).

Cheatsheet visual completa

Salve esta referência (ou imprima e cole no monitor):

• `# H1` `## H2` `### H3`
• `bold` `italic` `*bold italic*`
• `~~strikethrough~~` `\`code\`` `\`\`\`block\`\`\``
• `link` `!image`
• `> blockquote`
• `- bullet` `1. numbered` `- [ ] todo` `- [x] done`
• `---` (linha horizontal)
• `| col1 | col2 |` `| ---- | ---- |` `| a | b |`

Markdown editor com preview ao vivo

Decorar a sintaxe vem com prática. Para acelerar, use editor com preview ao vivo: você digita Markdown à esquerda, vê o HTML renderizado à direita em tempo real. Ideal para documentação técnica, posts de blog, READMEs.

O Markdown Editor do Quorify tem split view, syntax highlight, atalhos (Ctrl+B bold, Ctrl+I italic, Ctrl+K link), suporte GFM completo, exportação para HTML/MD/PDF. Funciona offline depois de carregar.

Onde Markdown NÃO funciona (e o que usar)

E-mail HTML: Markdown não renderiza em clientes de e-mail. Converta para HTML antes (Markdown → HTML → minifique com o HTML Minifier → cole).

Apresentações slides: existem ferramentas que renderizam Markdown como slides (Slidev, Marp), mas para slides complexos, ainda use PowerPoint/Keynote.

Documentos formais (TCC, ofício): Word/Pages/LibreOffice ainda dominam por requisitos formais (ABNT, formatação de página específica). Use Markdown para draft, depois importe.

Wikipedia: usa MediaWiki syntax, similar mas diferente de Markdown.

Conclusão

Markdown vale o investimento de 30 minutos para decorar a sintaxe básica — você economiza horas todo mês em documentação, READMEs, posts e mensagens. Use editor com preview ao vivo (como o Markdown Editor do Quorify) enquanto está aprendendo, depois você naturalmente decora os atalhos. Para casos específicos como tabelas complexas, o Gerador de Tabela Markdown acelera. Para conversão de caso (Title Case em headings), use o Conversor de Caso.