O que é o Markdown?

O Markdown é uma linguagem de marcação leve criada por John Gruber em 2004 que permite escrever texto formatado usando sintaxe de texto simples. Foi concebida para ser legível mesmo na sua forma bruta — asteriscos para ênfase, cerquilhas para títulos, travessões para listas. O Markdown é amplamente utilizado em documentação (READMEs do GitHub), aplicações de tomada de notas (Obsidian, Notion), plataformas de blogues e comunicação entre programadores.

Esta ferramenta fornece uma pré-visualização ao vivo do seu Markdown enquanto escreve. O painel esquerdo mostra o código fonte Markdown bruto e o painel direito renderiza o resultado formatado em tempo real. Suporta Markdown padrão, extensões do GitHub-Flavored Markdown (GFM) (tabelas, listas de tarefas, texto tachado, blocos de código delimitados) e realce de sintaxe para blocos de código.

Sintaxe básica do Markdown

• Títulos: use # para H1, ## para H2, ### para H3, e assim sucessivamente até ###### para H6.
• Negrito: envolva o texto em asteriscos duplos ou underscores duplos. Itálico: use asteriscos ou underscores simples.
• Listas: inicie linhas com - ou * para pontos, ou 1. para listas numeradas. Aninhe com indentação.
• Ligações: [texto da ligação](URL). Imagens: .
• Código: use crases para código inline, crases triplas para blocos de código delimitados com língua opcional para realce de sintaxe.

Como utilizar esta ferramenta

Escreva ou cole Markdown no editor. A pré-visualização atualiza em tempo real. Pode alternar entre os modos lado a lado e apenas pré-visualização. A ferramenta suporta copiar para a área de transferência (tanto o código fonte Markdown como o HTML renderizado), transferir como ficheiro .md e exportar como HTML.

GitHub Flavored Markdown

O GitHub Flavored Markdown expande o Markdown padrão com tabelas (colunas separadas por pipe), listas de tarefas (caixas de verificação com - [ ] e - [x]), texto tachado (envolvido em tis duplos), URLs com hiperligação automática e blocos de código delimitados com realce de sintaxe. Esta ferramenta suporta todas as funcionalidades GFM, tornando-a ideal para pré-visualizar ficheiros README e documentação antes de enviar para o GitHub.

Perguntas frequentes

Posso usar HTML dentro do Markdown?

Sim. O Markdown padrão permite HTML inline para qualquer coisa que a sintaxe Markdown não consiga expressar (como tabelas complexas, texto colorido ou vídeos incorporados). No entanto, alguns renderizadores de Markdown (como o GitHub) removem certas tags HTML por razões de segurança. Esta ferramenta de pré-visualização renderiza a maioria das tags HTML para mostrar o resultado esperado.

Qual é a diferença entre Markdown e rich text?

O rich text (como os documentos Word) armazena a formatação como códigos ocultos dentro do ficheiro. O Markdown armazena a formatação como caracteres de texto visíveis — **negrito** é literalmente digitado com asteriscos. Isto torna os ficheiros Markdown portáteis (qualquer editor de texto pode lê-los), compatíveis com controlo de versões (os diffs são limpos) e à prova de futuro (sem formato proprietário com que se preocupar).