Conv. Markdown

Converta entre Markdown e HTML com prévia

Instruções de Uso

🚀 Início rápido

  • Cole o conteúdo no campo à esquerda
  • Escolha o modo (→HTML ou →Markdown)
  • Conversão automática; resultado à direita
  • Prévia/Saída HTML: Markdown → HTML renderiza KaTeX/Mermaid por padrão

📌 Cenários comuns

  • Blogs/Docs: verificar rapidamente o render e as cores
  • Envio por e‑mail: colar o HTML exportado no corpo do e‑mail (estilos inline recomendados)
  • Rich text → Markdown: limpar rich text de web/CMS para controle de versões
  • Documentação técnica: renderizar fórmulas/diagramas e exportar de uma só vez
  • Migração de editor: conciliar diferenças entre sabores de Markdown
  • Wiki/KB: converter páginas HTML para Markdown e importar
  • Changelog de API: converter HTML/descrições em Markdown para revisão/PR

🎛️ Parâmetros de conversão e renderização

  • Markdown → HTML renderiza KaTeX/Mermaid automaticamente
  • HTML → Markdown mantém/restaura a fonte; sem re-renderização
  • GFM (tabelas/tarefas) ativado por padrão; para comportamento estrito use Markdown padrão
  • Quebras suaves ativas; para comportamento estrito use linha em branco ou dois espaços no final
  • Entradas muito grandes podem acionar prévia degradada (limitar renderização/desativar destaque)

🧭 Dicas de uso

  • E‑mail: prefira estilos inline para compatibilidade
  • Textos longos: converta em partes para evitar lentidão

⚠️ Limitações & compatibilidade

  • Variedades: o render varia entre plataformas; prefira sintaxe comum
  • HTML → Markdown é melhor esforço: estilos/layout costumam se perder
  • HTML → Markdown ignora partes do HTML (scripts/estilos/meta, embeds/formulários, mídia, eventos on*, style/class etc.)
  • Tabelas complexas/aninhadas podem ser simplificadas; revise
  • Imagens/vídeo permanecem links externos; não são baixados
  • Mermaid SVG pré-renderizados por terceiros não são reversíveis com confiança

🔒 Privacidade & segurança

  • Todo o processamento ocorre no seu navegador; os dados não saem do seu dispositivo
  • Não executa <script> colados
  • KaTeX/Mermaid com configuração segura
  • Não sanitiza todo o HTML automaticamente; revise antes/depois da conversão

❓ Perguntas frequentes

A prévia difere da plataforma de destino — como diagnosticar?

Identifique o ‘sabor’ de Markdown (CommonMark/GFM/personalizado). Evite HTML cru e extensões privadas. Use quebras padrão (linha em branco ou dois espaços no final). Reduza a um exemplo mínimo, valide no destino e só então amplie.

Como publicar o HTML exportado com segurança em produção?

A ferramenta não executa <script>, mas também não sanitiza automaticamente. Faça a sanitização no servidor/pipeline com uma biblioteca de lista branca (ex.: DOMPurify), bloqueie on* e esquemas perigosos e aplique CSP para scripts externos/inline.

HTML → Markdown distorce estruturas complexas — o que fazer?

Prefira semânticas portáveis: converta tabelas/listas aninhadas em tabelas pipe e listas mais rasas; cole como texto simples para remover span/style/class antes de converter; isole um caso mínimo e ajuste a fonte.

Limites e troubleshooting de KaTeX/Mermaid

Sintaxe: KaTeX $$…$$ ou inline $…$; Mermaid cercado como ```mermaid. Entradas grandes podem sofrer degradação (mostrar fonte/desativar destaque). Reduza a densidade, converta em partes e use exemplos mínimos. Recuperação: KaTeX pode ser restaurado a partir do HTML renderizado; Mermaid apenas para diagramas gerados pela ferramenta com fonte incorporada.

Conversor Markdown - Converter, Visualizar, Destacar Código - CrateX.app