Tabelas e listas em Markdown: formatação avançada com exemplos
Enquanto os elementos básicos do Markdown são intuitivos, alguns recursos como tabelas, listas aninhadas, blocos de código com syntax highlighting e callouts têm sintaxes mais específicas que podem ser confusas. Dominar esses elementos permite criar documentação e artigos significativamente mais ricos e informativos. A Pré-visualização Markdown da WikiPlus é a ferramenta ideal para experimentar e verificar esses elementos antes de publicar — veja o resultado renderizado em tempo real enquanto você escreve.
Tabelas em Markdown: sintaxe e alinhamento de colunas
Tabelas são um dos elementos mais usados em documentação técnica e são parte do GitHub Flavored Markdown. Sintaxe básica: | Coluna 1 | Coluna 2 | Coluna 3 | na primeira linha. | --- | --- | --- | na segunda linha (define o separador de cabeçalho). | Valor 1 | Valor 2 | Valor 3 | nas linhas seguintes. Para alinhamento: | :--- | centraliza à esquerda (padrão). | ---: | alinha à direita (ideal para números). | :---: | centraliza. Cada coluna pode ter alinhamento diferente. Dicas para tabelas legíveis no Markdown bruto: alinhe as colunas manualmente com espaços (não obrigatório mas melhora a legibilidade do código). Extensões do VS Code como Table Formatter fazem esse alinhamento automaticamente. A Pré-visualização Markdown da WikiPlus renderiza tabelas corretamente e permite ver o resultado enquanto você digita.
Listas aninhadas, ordenadas e de tarefas
Markdown suporta vários tipos de lista. Listas não ordenadas: use -, * ou + como prefixo. Listas ordenadas: use números seguidos de ponto (1., 2., 3.). O número real não importa — você pode usar 1. em todos os itens e o Markdown renderiza sequencialmente. Listas aninhadas: indente com 2 ou 4 espaços para criar sublista. Uma lista pode misturar ordenada e não ordenada: um item numerado pode ter subitens com -. Listas de tarefas (GFM): - [ ] Pendente e - [x] Concluído renderizam como checkboxes no GitHub e em muitas outras plataformas. Para continuação de parágrafo dentro de item de lista: pressione Enter e indente o parágrafo ao nível do texto do item (não do marcador). Listas com múltiplos parágrafos por item são úteis em documentação detalhada. A Pré-visualização Markdown da WikiPlus verifica o aninhamento correto das listas em tempo real.
Blocos de código com syntax highlighting
Blocos de código são essenciais em documentação técnica. Código inline: envolva com backtick simples: `const x = 1`. Bloco de código: use três backticks na primeira linha, especifique a linguagem opcional, o código, e três backticks no final. Linguagens comuns suportadas: javascript, typescript, python, bash, sh, sql, json, yaml, html, css, jsx, tsx, go, rust, java, c, cpp, csharp, php, ruby, markdown, dockerfile, nginx. A especificação da linguagem após os três backticks (```python) ativa o syntax highlighting específico da linguagem. Para blocos de código com linha de destaque (não suportado em todos os contextos): alguns processadores Markdown suportam // highlight-next-line como comentário antes da linha a destacar. Para exemplos de código que precisam ser copiados: em GitHub e muitos sites de documentação, o bloco de código tem um botão de cópia automático. A Pré-visualização Markdown da WikiPlus renderiza syntax highlighting para verificar a aparência visual.
Citações, notas de rodapé e referências em Markdown
Elementos menos conhecidos do Markdown que adicionam riqueza ao conteúdo. Citações (blockquote): > texto citado cria um bloco de citação visualmente destacado. Aninhamento: >> para citação dentro de citação. Notas de rodapé (extensão do GFM): [^1] no texto principal e [^1]: Texto da nota de rodapé no final do documento — renderiza como superscript clicável com a nota no final. Links de referência: [texto do link][id] no texto e [id]: https://url.com em qualquer lugar do documento — útil para reutilizar URLs e manter o texto principal limpo. Texto riscado (GFM): ~~texto~~ renderiza como texto tachado. Texto destacado (não Markdown padrão, mas suportado em alguns contextos): ==texto== renderiza com destaque amarelo. Subscript e superscript (extensão): H~2~O e X^2^ em alguns parsers Markdown. A Pré-visualização Markdown da WikiPlus suporta os elementos padrão e as extensões GFM mais comuns.
Perguntas frequentes
- Como criar uma linha horizontal em Markdown?
- Use três ou mais hífens (---), asteriscos (***) ou underscores (___) em uma linha isolada. O GitHub e a maioria dos parsers renderizam isso como uma tag <hr>. Atenção: --- logo após um parágrafo sem linha em branco pode ser interpretado como indicador de cabeçalho H2 em alguns parsers — sempre deixe uma linha em branco antes.
- Posso ter links com títulos (tooltip) em Markdown?
- Sim. Use a sintaxe: [texto do link](https://url.com 'Título do tooltip'). O texto entre aspas aparece como tooltip ao hover sobre o link. Também funciona com links de referência: [texto][id] e depois [id]: https://url.com 'Título do tooltip'. Isso é especialmente útil para links em documentação onde contexto adicional é valioso.
- Como escapar caracteres especiais do Markdown (como * e _)?
- Use a barra invertida antes do caractere especial: \* para asterisco literal, \_ para underscore literal, \# para hash literal, \[ para colchete. Você pode escapar: \, `, *, _, {, }, [, ], (, ), #, +, -, ., !. Em blocos de código inline e de bloco, todos os caracteres são tratados como literais sem necessidade de escape.