Markdown para HTML

O Markdown para HTML é uma ferramenta gratuita que converte trechos de Markdown em código HTML bruto para uso em sites, sistemas de conteúdo e fluxos de desenvolvimento.

O que o Markdown para HTML converte?

A ferramenta transforma a formatação Markdown nos elementos HTML correspondentes. Um título vira um elemento de título, um link vira um elemento de âncora e uma lista com marcadores vira uma lista não ordenada com seus respectivos itens.

Markdown é um formato de marcação em texto simples muito usado em arquivos README, documentação técnica, descrições de problemas e conteúdo de sites estáticos. Convertê-lo em HTML é útil quando o destino aceita HTML, mas não Markdown, como um modelo de site, um sistema de e-mail ou um campo de sistema de gerenciamento de conteúdo.

Existem diversos dialetos de Markdown. CommonMark, GitHub Flavored Markdown e analisadores específicos de aplicativos podem tratar tabelas, listas de tarefas, quebras de linha e HTML incorporado de maneiras diferentes. As informações de origem da ferramenta não especificam um dialeto, portanto, verifique qualquer sintaxe além de títulos, parágrafos, links e listas comuns antes de usar o resultado.

Como converter Markdown em HTML?

Insira o texto de origem no campo Markdown, execute a conversão e leia ou copie o código gerado no campo HTML.

1. Cole um trecho completo, não apenas um marcador de formatação isolado.
2. Converta o texto e examine a estrutura dos elementos no HTML retornado.
3. Confira links, listas aninhadas e blocos de código no aplicativo que exibirá o conteúdo.
4. Aplique os estilos do site separadamente caso o destino ainda não tenha um CSS adequado.

A conversão ocorre no servidor. O conteúdo inserido é enviado ao servidor por HTTPS e não fica armazenado. Como o texto sai do seu dispositivo para ser processado, não envie credenciais, chaves privadas nem materiais confidenciais quando a política da sua organização proibir ferramentas que processam dados no servidor.

Como interpretar o HTML retornado?

Leia o resultado como código HTML bruto, com elementos que representam a estrutura do Markdown. Ele pode ser adequado para inserção em uma página, um modelo ou um campo de conteúdo existente, mas não é necessariamente um documento HTML completo com doctype, metadados, estilos e scripts.

Em um exemplo simples de título, a entrada em texto simples é:

# Release notes

O resultado HTML convencional é:

<h1>Release notes</h1>

Uma entrada com uma lista curta é:

- Alpha

- Beta

A estrutura correspondente é uma lista não ordenada com dois elementos de item:

<ul>

<li>Alpha</li>

<li>Beta</li>

</ul>

A maioria dos erros de Markdown não gera erros formais de análise. Um marcador de formatação sem par, uma indentação incorreta ou a ausência de espaço depois do marcador de lista pode simplesmente aparecer como texto comum. Se o HTML retornado parecer válido, mas a estrutura estiver errada, compare os elementos de saída com a hierarquia pretendida para o documento.

• Verifique se os títulos usam o nível esperado e não pulam desnecessariamente de um nível para outro.
• Confirme se os itens de listas aninhadas têm indentação consistente no Markdown de origem.
• Confira os destinos dos links antes de publicar, principalmente ao processar conteúdo de terceiros.
• Revise com atenção os blocos de código delimitados, pois um delimitador sem fechamento pode incorporar todo o restante do documento.
• Procure HTML bruto no conteúdo de origem, já que diferentes implementações de Markdown podem preservá-lo, escapá-lo ou rejeitá-lo.

Detalhes práticos da conversão

A conversão de Markdown altera a estrutura, não o idioma do texto. Letras acentuadas, alfabetos não latinos, números e sinais de pontuação comuns podem permanecer como conteúdo textual dentro dos elementos gerados. Caracteres com significado especial em HTML podem precisar ser codificados como entidades quando devem aparecer literalmente, em vez de formar marcação.

Espaços e linhas em branco podem afetar a análise. Normalmente, uma linha em branco separa parágrafos, enquanto a indentação pode criar uma lista aninhada ou um bloco de código. O comportamento das quebras de linha também varia entre os dialetos de Markdown, por isso uma única quebra de linha no conteúdo de origem nem sempre produz uma quebra visível no HTML.

Uma entrada vazia não tem uma estrutura de documento significativa para converter. Para entradas muito longas, pode ser melhor usar um processo de compilação local, que permita controle de versão, testes e conversão consistente com o mesmo analisador usado em produção. Nenhum conversor consegue determinar se o nível de um título, o destino de um link ou a hierarquia de uma lista está semanticamente correto para o seu projeto.

Quando vale a pena converter Markdown em HTML?

A conversão vale a pena quando o sistema de destino aceita HTML, mas o material de origem foi escrito ou fornecido em Markdown. Alguns casos comuns são verificar documentação de terceiros antes de importá-la, depurar a compilação de um site estático, preparar notas de versão para um editor que aceita apenas HTML ou revisar a marcação gerada antes da implantação.

Em geral, não vale a pena converter Markdown em HTML quando o conteúdo será lido apenas por uma máquina e o Markdown já funciona no formato exigido. Da mesma forma, converter Markdown logo no início de um fluxo pode dificultar edições posteriores caso os autores devam continuar trabalhando em Markdown.

Não minifique o HTML enquanto estiver depurando sua estrutura. Uma marcação legível facilita a identificação de aninhamentos incorretos e elementos inesperados. Depois de verificar a saída e prepará-la para uso em produção, o Minificador de HTML pode reduzir espaços em branco desnecessários.

Perguntas frequentes

O HTML convertido já vem com estilos CSS?

O HTML descreve a estrutura, enquanto o CSS controla a maior parte da apresentação. Um elemento de título pode ter aparências diferentes em cada site porque o navegador, o aplicativo ou o tema fornece os estilos. Adicione ou reutilize o CSS no destino, em vez de esperar que o Markdown de origem defina a aparência final.

Posso converter tabelas e listas de tarefas em Markdown?

O suporte depende do dialeto de Markdown usado pelo analisador. Tabelas e caixas de seleção de listas de tarefas são extensões comuns, não uma sintaxe universal de Markdown. Converta uma pequena amostra representativa e verifique os elementos retornados antes de usá-los em um documento maior.

É seguro converter Markdown de fontes não confiáveis?

Mesmo depois da conversão, trate Markdown de fontes não confiáveis como conteúdo não confiável. Dependendo do analisador e do destino, HTML incorporado ou esquemas de links inseguros podem exigir sanitização. Este conversor altera o formato, mas a conversão por si só não deve ser considerada um filtro de segurança.

Posso colar o HTML no WordPress ou em outro CMS?

Geralmente sim, desde que o editor tenha uma visualização de HTML ou código e permita os elementos retornados. Alguns sistemas de gerenciamento de conteúdo sanitizam a marcação colada, removem atributos não compatíveis ou alteram o espaçamento entre parágrafos. Visualize o conteúdo e confira a versão salva, pois o CMS pode transformá-lo depois do envio.

Por que meu bloco de código aparece incorretamente?

Confira se os delimitadores de abertura e fechamento são iguais e aparecem em linhas separadas. Blocos de código indentados também podem apresentar problemas quando a indentação das listas ao redor é inconsistente. Se precisar de destaque de sintaxe, o destino deverá reconhecer o identificador de linguagem e fornecer seu próprio script ou seus próprios estilos de destaque.

Devo guardar o Markdown depois da conversão?

Guarde o Markdown quando ele for a fonte oficial e editável. Armazene o HTML gerado separadamente ou recrie-o durante a compilação para evitar que edições posteriores deixem os dois formatos diferentes. Antes de publicar, valide os links e confira o fragmento no destino real, em vez de depender apenas do código bruto.