Como usar
- Digite Markdown no editor ou pressione “Testar um exemplo” para carregar um documento com tabelas e uma lista de tarefas.
- Acompanhe a pré-visualização enquanto digita. Alterne para “Código-fonte HTML” para ver a marcação gerada.
- Ative ou desative o GitHub Flavored Markdown ou as quebras de linha simples para adaptar o resultado ao local onde o texto será publicado.
- Copie o HTML para um CMS ou e-mail, ou baixe o resultado como arquivo .html ou .md.
Como funciona
O Markdown é convertido com marked, um parser de código aberto bastante usado que segue a especificação CommonMark e, com a opção GFM ativada, o GitHub Flavored Markdown: tabelas com barras verticais e alinhamento de colunas, listas de tarefas, ~~tachado~~ e links automáticos para URLs sem formatação. Notas de rodapé, fórmulas matemáticas e diagramas Mermaid não fazem parte dessas especificações e são exibidos como texto simples.
O Markdown pode conter HTML bruto, que é repassado sem alterações, como acontece na maioria dos renderizadores de Markdown. Para manter sua segurança, a pré-visualização nunca é inserida nesta página. Ela é renderizada em um frame isolado que não pode executar scripts, enviar formulários, abrir janelas pop-up nem acessar este site; além disso, a política de segurança de conteúdo bloqueia scripts, folhas de estilo externas, fontes e frames. Uma tag <script> ou um atributo onclick no seu Markdown aparece no código-fonte HTML, mas nunca é executado. Os links da pré-visualização são exibidos, mas não abrem; copie a URL se precisar acessá-los.
A pré-visualização usa uma folha de estilos neutra, semelhante à de renderizadores comuns de README; seu site ou o GitHub pode estilizar o mesmo HTML de outra forma. O HTML copiado é apenas o fragmento, sem estilos; o arquivo .html baixado inclui uma folha de estilos básica para ter a mesma aparência da pré-visualização. O HTML baixado ou copiado não é sanitizado; portanto, se contiver scripts, eles serão executados onde você colar ou abrir o arquivo.
Exemplos
Conferir um README antes de enviar
Cole o README.md para conferir se as colunas da tabela estão alinhadas, se a lista de tarefas aparece como caixas de seleção e se os blocos de código estão delimitados corretamente, antes de enviar o arquivo para o GitHub.
Escrever para um CMS que aceita HTML
Escreva um rascunho de post de blog em Markdown e pressione “Copiar HTML” para colar as marcações <h2>, <p> e <ul> no editor HTML do CMS.
Quebras de linha como em chats
O texto de um app de chat tem linhas separadas por quebras de linha simples. Ativar “Tratar quebras de linha simples como <br>” mantém essas linhas separadas, em vez de juntá-las em um único parágrafo.
Perguntas frequentes
É seguro colar Markdown de uma fonte desconhecida?
Sim, para pré-visualizar. O HTML renderizado é exibido em um frame isolado com scripts desativados; assim, até uma tag <script> ou um manipulador de eventos no texto não faz nada aqui. Tenha cuidado ao colar o HTML exportado, pois ele não é sanitizado.
Por que minhas imagens não aparecem?
Imagens de outros sites são bloqueadas por padrão para que a pré-visualização não faça solicitações à rede. Ative “Carregar imagens de outros sites” para exibi-las. Caminhos relativos, como ./docs/screenshot.png, não funcionam porque os arquivos não estão aqui.
A ferramenta é compatível com notas de rodapé, fórmulas ou diagramas?
Não. A ferramenta é compatível com CommonMark e GitHub Flavored Markdown (tabelas, listas de tarefas, tachado e links automáticos). Notas de rodapé, fórmulas LaTeX e diagramas Mermaid são extensões que esta pré-visualização exibe como texto simples.
Por que uma quebra de linha simples não inicia uma nova linha?
No Markdown padrão, uma quebra de linha simples dentro de um parágrafo é tratada como um espaço. Termine a linha com dois espaços, deixe uma linha em branco ou ative “Tratar quebras de linha simples como <br>”.
Privacidade
O Markdown é convertido no seu navegador e não é enviado nem armazenado. A pré-visualização não carrega nada da internet, a menos que você permita imagens de outros sites; nesse caso, elas são solicitadas diretamente aos respectivos servidores.