Guia de escrita: tudo que dá para usar nos posts
Referência rápida de Markdown para este blog: títulos, listas, callouts estilo Obsidian, tabelas, código, links entre posts e destaques.
Este post é uma referência viva: tudo o que aparece aqui pode ser usado em qualquer post. Abra o arquivo guia-de-escrita-markdown.md lado a lado para ver o código de cada exemplo.
Títulos e estrutura
Use ## para seções e ### para subseções. O título principal (#) é criado automaticamente a partir do campo title, então não use # no texto.
Com 3 ou mais seções, o post ganha um sumário automático, na lateral no PC e recolhível no celular.
Uma subseção
Subseções aparecem recuadas no sumário.
Texto
Você pode usar negrito, itálico, riscado, código inline e texto destacado (estilo Obsidian).
Uma citação simples fica assim, com uma barra à esquerda.
Listas
- Item de lista
- Outro item
- Item aninhado
- Primeiro passo
- Segundo passo
- Tarefa concluída
- Tarefa pendente
Callouts
Callouts usam a mesma sintaxe do Obsidian: > [!tipo] Título opcional.
Outros tipos: info, exemplo, citacao, resumo, todo.
Links
- Link comum: Documentação do Markdown
- Link para outro post (estilo Obsidian): bem-vindo
- Com texto personalizado: como organizo minhas notas
Quando um post cita outro com [[...]], o post citado mostra automaticamente a seção “Mencionado em” no final, como os backlinks do Obsidian.
Tabelas
| Recurso | Sintaxe | Onde aparece |
|---|---|---|
| Destaque | ==texto== | Qualquer parágrafo |
| Link interno | [[slug]] | Qualquer parágrafo |
| Callout | > [!dica] | Bloco separado |
No celular, tabelas largas rolam para o lado sem quebrar a página.
Código
// Blocos de código têm cores e botão "Copiar"
function saudacao(nome) {
return `Olá, ${nome}!`;
}Imagens
Coloque a imagem em public/imagens/ e use:
A descrição (texto alternativo) é importante para acessibilidade e para o Google Imagens.
Uma linha horizontal (---) separa blocos de conteúdo.