Publicação de Markdown para HTML: Guia de Cobertura de Sintaxe GFM e Estilização Inline

GFM é a especificação de extensão Markdown definida pelo GitHub, que inclui quatro tipos comuns de extensões para além da sintaxe básica. O conversor de Markdown para HTML do OKfmt suporta a conversão completa de formato para todos os quatro tipos de extensões, e produz tags HTML que correspondem à semântica padrão.

Os quatro tipos de extensões são tabelas com atributos de alinhamento, texto riscado, listas de tarefas e blocos de código delimitados. Após a conversão, a estrutura e a informação de estilo da sintaxe original são retidas, o que cumpre os requisitos de exibição da maioria das plataformas de publicação de conteúdo público.

O conversor de Markdown para HTML do OKfmt produz por padrão um documento HTML5 completo com declaração DOCTYPE, e todos os estilos de tipografia são escritos nas tags correspondentes como CSS inline. O resultado da conversão pode ser exibido normalmente sem depender de folhas de estilo externas.

Esta saída é adequada para cenários de publicação que não suportam estilos externos, como corpos de e-mail internos de empresas, sistemas de gestão de conteúdo que não permitem CSS personalizado e áreas de edição de rich text de plataformas de blog de terceiros. Os utilizadores podem copiar o código HTML convertido e colá-lo diretamente para publicação.

Alguns editores Markdown permitem que os utilizadores insiram tags HTML brutas no conteúdo. Estas tags podem conter código de script malicioso, o que traz riscos de segurança para as páginas publicadas. O OKfmt adota um mecanismo de proteção que não renderiza tags HTML de entrada brutas.

A ferramenta converte as tags HTML brutas no conteúdo de entrada para saída como texto simples, impedindo que as tags sejam executadas no documento HTML convertido, evitando ataques de injeção de script cross-site XSS e garantindo a segurança de acesso das páginas publicadas.

O conversor de Markdown para HTML do OKfmt apenas realiza conversão de formato, e não processa a transferência ou armazenamento de recursos de imagem. Durante a conversão, os endereços de link de imagem no conteúdo Markdown original são retidos e escritos diretamente no atributo src da tag img no HTML gerado.

Os utilizadores precisam de carregar as imagens originais para a hospedagem de imagens ou servidor de armazenamento da plataforma alvo por si mesmos, e depois substituir os endereços de link correspondentes. A própria ferramenta não armazena nenhum conteúdo carregado por utilizadores, e todas as operações de conversão são concluídas no navegador local do utilizador.

O OKfmt também fornece um serviço de conversão inversa de formato HTML para Markdown. O cenário principal de aplicação deste serviço é o arquivamento em Markdown de conteúdo web público. Os utilizadores podem copiar o conteúdo HTML do texto de uma página web para convertê-lo em texto Markdown estruturado para armazenamento.

O processo de conversão retém a estrutura do conteúdo original, incluindo níveis de cabeçalho, listas, links e imagens, e remove código redundante como navegação e anúncios que acompanham a página web. O Markdown convertido pode ser usado para arquivamento de notas de conhecimento pessoal, ou republicado após edição secundária.