O que faz
O conversor de Markdown para HTML transforma texto Markdown em marcação HTML que você pode colar em um CMS, um modelo de e-mail, uma página estática ou qualquer lugar que aceite HTML mas não Markdown. É útil para publicar um README em um site, levar anotações para um editor de blog ou conferir exatamente quais tags um trecho de Markdown produz.
A saída é o mesmo HTML gerado pelos renderizadores de Markdown mais populares: títulos <h1> a <h6>, parágrafos <p>, listas <ul> e <ol>, blocos <pre><code> com uma classe language- para realçadores de sintaxe e marcação <table> para tabelas no estilo do GitHub.
Como usar
- Digite ou cole Markdown, envie um arquivo
.mdou clique em Exemplo. - Escolha as opções de que precisa: GitHub Flavored Markdown, quebras de linha como
<br>, IDs nos títulos para links âncora, sanitização para entradas não confiáveis e um documento HTML completo em vez de um fragmento. - Copie o HTML ou baixe como arquivo
.html.
O resultado é atualizado enquanto você digita. Deixe a opção de documento completo desligada ao colar o resultado em uma página existente e ligue-a quando quiser um arquivo independente.
Exemplo
Este Markdown:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
vira este HTML:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>
Dicas
- Por padrão, o HTML bruto dentro do Markdown é mantido como está, que é o que a maioria dos renderizadores faz. Ative a sanitização sempre que o Markdown tiver sido escrito por outra pessoa.
- Com os IDs nos títulos ativados, você pode linkar para uma seção com um endereço como
page.html#installe montar um sumário a partir dos títulos. - Os blocos de código mantêm a linguagem como classe, então realçadores como Prism ou highlight.js os reconhecem sem trabalho extra.
- Para ver o resultado renderizado lado a lado, use a pré-visualização de Markdown. Para o caminho inverso, use o conversor de HTML para Markdown.
Perguntas frequentes
› Qual sintaxe de Markdown é suportada?
Todo o CommonMark, como títulos, ênfase, links, imagens, listas, citações, código e linhas horizontais. Com o GitHub Flavored Markdown ativado você também tem tabelas com alinhamento de colunas, listas de tarefas, tachado e links automáticos para URLs soltas.
› O que faz a opção de sanitizar?
Ela escapa todo o HTML bruto do Markdown para que apareça como texto em vez de virar tags, e remove links e imagens cuja URL usa um esquema perigoso como javascript ou vbscript. Ative quando o Markdown vier de usuários em quem você não confia, como comentários ou posts de fórum.
› Como os IDs dos títulos são gerados?
Do mesmo jeito que no GitHub. O texto do título vai para minúsculas, a pontuação é removida e os espaços viram hifens, então Getting Started recebe o id getting-started. Títulos repetidos recebem -1, -2 e assim por diante, o que mantém cada âncora única.
› Para que serve a opção de documento HTML completo?
Ela envolve o resultado em uma página completa com doctype, charset UTF-8, tag viewport, um título tirado do primeiro título de nível um e uma pequena folha de estilos legível. Salve como arquivo .html e ele abre bem em qualquer navegador.
› Meu Markdown é enviado para algum lugar?
Não. A conversão roda no seu navegador com a biblioteca marked e nada é enviado a um servidor.