Como usar a ferramenta Markdown para HTML
- Adicione MarkdownCole Markdown na caixa da esquerda, ou solte ou abra um arquivo .md.
- Escolha a saídaEscolha “Somente código HTML” para um CMS ou site, ou “Página HTML completa” para um arquivo independente com estilos.
- Confira o resultadoO código HTML se atualiza enquanto você digita. Mude para Pré-visualizar para ver a aparência.
- Copie ou baixeCopie o HTML para a área de transferência ou baixe como arquivo .html.
Recursos
- Código limpo e legívelOs elementos de bloco ficam em linhas próprias e com recuo, prontos para colar em um modelo.
- GitHub Flavored MarkdownTabelas com alinhamento, listas de tarefas, tachado, blocos de código e links automáticos.
- Saída seguraScripts, manipuladores de eventos e outro HTML inseguro no Markdown são removidos.
- Opções de linksAdicione opcionalmente target="_blank" e rel="noopener" aos links externos.
Quando converter Markdown em HTML
Markdown é gostoso de escrever, mas navegadores, editores de e-mail e muitos CMS precisam de HTML. Ao converter, você obtém código que pode colar em qualquer lugar. Os elementos de bloco ficam em linhas próprias e com recuo, prontos para um template.
- Publicar um README ou uma página de documentação num site
- Colar no WordPress, no Blogger ou numa ferramenta de newsletter um artigo escrito num app de Markdown
- Transformar anotações numa página web independente para compartilhar ou arquivar
- Conferir exatamente qual HTML um trecho de Markdown gera
No que cada elemento se transforma
| Markdown | HTML |
|---|---|
| # Título | <h1>Título</h1> |
| **negrito** | <strong>negrito</strong> |
| [texto](url) | <a href="url">texto</a> |
| - item | <ul><li>item</li></ul> |
| Tabela com barras verticais | <table> com <thead> e <tbody> |
| Cerca ```js | <pre><code class="language-js"> |
Dois tipos de saída
«Somente código HTML (para um CMS ou site)» gera tags limpas sem estilo, para que o CSS do seu site decida fontes e cores. «Página HTML completa com estilos» gera um documento independente com título e tipografia legível, que fica bonito quando aberto no navegador. Com «Abrir links em uma nova aba», os links externos recebem target="_blank" e rel="noopener". Scripts, manipuladores de eventos e outros trechos de HTML inseguros no Markdown são removidos.
Problemas comuns e como resolver
- Uma lista sai como um parágrafo comprido: o Markdown precisa de uma linha em branco antes do primeiro item. Adicione essa linha acima da lista.
- As quebras de linha somem: uma quebra simples dentro de um parágrafo conta como espaço. Deixe uma linha em branco para um novo parágrafo, termine a linha com dois espaços ou ative «Quebras de linha como no texto».
- Aparecem asteriscos ou sublinhados no texto: * e _ iniciam formatação. Coloque uma barra invertida antes (\*) se quiser o caractere literal.
- Uma tabela não é convertida: ela precisa de uma linha de cabeçalho, uma linha de hifens logo abaixo e o mesmo número de colunas em todas as linhas.
- O HTML fica simples demais no meu site: é o esperado; o código não leva estilos. Se quiser um arquivo que já fique bonito sozinho, baixe a página completa.
Antes de colar o HTML num CMS como o WordPress, mude o editor para a visualização de código ou use um bloco «HTML personalizado»; no editor visual as tags apareceriam como texto. Para escrever com prévia e salvamento automático, use o Editor de Markdown, e para o caminho inverso, HTML para Markdown.