Guia completo de Markdown (PT) | Markdown2Image

Markdown continua sendo a forma mais rápida de escrever documentação técnica e materiais visuais. Este cheat sheet em português segue o fluxo do Markdown2Image para transformar notas em cards, posts ou apresentações sem retrabalho.

🎯 Destaques

Conteúdo inteiro em um arquivo: títulos, texto rico, tabelas e mídias organizados
Exemplos reais: cada seção mostra um uso prático
Guia de layout: proporções 16:9 e 4:5 para manter o frame limpo
Checklist acoplada: evita surpresas antes da publicação

📝 Formatação essencial

_itálico_ / **negrito** / ~~tachado~~
***negrito + itálico***
`código inline` e ```blocos multilinha```
> Citações encadeiam com ">"

Nota de campo: delimite comandos e caminhos com backticks para preservar contraste no Markdown2Image.

Formatos avançados

==Destaque== para alertas
<u>Sublinhado</u> usando HTML
H~2~O / 10^3^ para subscrito/sobrescrito

🔗 Links e referências

[Link padrão](https://example.com)
[Link com título](https://example.com "Tooltip")
[E-mail](mailto:[email protected])
[Telefone](tel:+5511999990000)

[GitHub]: https://github.com "Repositório"
Detalhes adicionais em [GitHub]

Dica: Em artigos longos prefira links por referência para facilitar revisão e tradução.

🖼️ Imagens e mídia

![Hero](hero.png "Laptop e código")
![Largura fixa](flow.png =480x)
![Duas colunas](img-left.png){width="48%"}
![Zoom ao clicar](diagram.png){data-zoomable}

Insira legendas logo abaixo usando *Descrição*
Suba imagens com pelo menos 1200px de largura para manter qualidade retina

📊 Organização e estrutura

Listas

- Entrega principal
  - Subtarefa
1. Preparar
2. Executar
   1. API
   2. UI
- [x] feito / [ ] pendente

Lista de definições

Markdown
: Linguagem leve para estruturar texto

Markdown2Image
: Ferramenta que converte Markdown em slides/visuais

Tabelas

| Comando | Finalidade | Observação |
| --- | --- | --- |
| `npm install` | Instalar dependências | Confirme a versão do Node |
| `pnpm build` | Build de produção | Use --filter para módulos |

⚙️ Workflow sugerido

Rascunhe em Obsidian ou VS Code
Traduza/localize no post_translations, cuidando de slug e SEO por idioma
Valide com markdownlint e testes internos
Converta no Markdown2Image reaproveitando templates da marca
Publique via aprovação no Directus e webhook do site

🧪 Checklist de QA

Todos os blocos têm highlight de sintaxe
URLs usam HTTPS e estão ativas
Tabelas não passam de três colunas
SEO inclui palavras-chave em português
Layout foi testado em 16:9 e 4:5 dentro do Markdown2Image

🔚 Conclusão

Escrever com consistência reduz o tempo de revisão quando o conteúdo vira imagem. Use este guia como template base para manter localização, QA e publicação sob controle.

Guia completo de Markdown: produtividade máxima com Markdown2Image