Pré-visualização Markdown
Pré-visualização Markdown gratuita com HTML seguro.
Pré-visualização de Markdown no navegador
Escreva Markdown à esquerda e examine o resultado à direita. A pré-visualização trata cabeçalhos, ênfase, ligações, listas, citações, linhas divisórias e blocos de código delimitados.
**Vale a pena saber que o Markdown não tem uma especificação oficial única.** A sintaxe original de 2004 deixou bastantes casos por definir, pelo que o GitHub, o CommonMark e os restantes divergem em pormenores como listas encaixadas, quebras de linha ou sublinhados dentro de uma palavra: um documento impecável num sítio pode ser apresentado de outra forma noutro. O que mais engana são as quebras de linha, porque **na maioria das implementações uma única quebra não produz quebra dentro do parágrafo**: são precisos dois espaços no fim da linha ou uma linha em branco.
Esta ferramenta escapa o HTML em bruto antes de o mostrar, pelo que aquilo que colar não pode executar código aqui.
Como usar a pré-visualização
- Cole ou escreva Markdown Escreva no editor da esquerda e a pré-visualização atualiza-se de imediato.
- Reveja o resultado apresentado Verifique cabeçalhos, listas, ligações e código antes de publicar.
- Copie o HTML se precisar O HTML seguro gerado pode ser levado para um editor compatível.
Dicas para aproveitar melhor
- Delimite o código com três acentos graves para conservar a indentação e os símbolos do original.
- A pré-visualização mostra o HTML em bruto como texto de propósito, para reduzir o risco de injeção de código.
- As tabelas e as listas encaixadas são o que mais se torce por causa da indentação: convém ajustá-las olhando para a pré-visualização.
Situações de uso
Rever um README enquanto se escreve
**O que vê no seu editor e o que o GitHub apresenta não coincidem necessariamente.** Isto permite olhar antes de publicar.
Deixar bem tabelas e listas encaixadas
Onde o resultado depende da posição de um símbolo ou da indentação, ver é mais rápido do que raciocinar.
Levar um artigo em HTML
**O HTML gerado pode ser copiado tal como está**, servindo de rascunho para colar num gestor de conteúdos.
Transformar um documento em PDF para entregar
Um procedimento ou umas notas escritas em Markdown ficam numa forma que se pode dar sem mais.
Aprender a sintaxe pelo caminho
**Com a entrada e o resultado lado a lado, aprende-se o que cada símbolo faz experimentando.**
Termos de Markdown
- Markdown
- Sintaxe leve que marca cabeçalhos e ênfase com sinais de pontuação. **Não existe uma especificação oficial única e as implementações divergem.**
- CommonMark
- Especificação que fixou os casos que a original deixou por definir. Hoje a maioria das implementações parte dela.
- GitHub Flavored Markdown
- CommonMark com tabelas, rasurado e listas de tarefas acrescentados. **O aspeto de um documento no GitHub segue isto.**
- Tratamento da quebra de linha
- **Em quase todas as implementações, uma única quebra não produz quebra dentro do parágrafo.** São precisos dois espaços finais ou uma linha em branco.
- Bloco de código delimitado
- Região fechada entre três acentos graves. Nomear a linguagem após a abertura ativa a coloração.
- Saneamento
- Retirar do HTML colado os elementos perigosos. **Esta pré-visualização fá-lo para mostrar com segurança.**
Perguntas frequentes
Porque convém ver antes de publicar
O Markdown escreve-se com desembaraço, mas basta faltar um carácter para que a estrutura de uma página mude. Uma pré-visualização em direto põe à vista cabeçalhos, ligações e listas antes de colar o texto num README, numa questão, num wiki ou num gestor de conteúdos.
Esta ferramenta prefere um subconjunto comum e seguro a executar HTML arbitrário. Isso torna-a útil tanto para rever conteúdo copiado de uma fonte pouco fiável como para redigir o próprio.