Converter BBCode para HTML

Cole um texto com negrito, itálico, sublinhado, URL, citação ou lista e receba uma string HTML pronta para uso controlado em uma página ou fluxo editorial. As tags reconhecidas podem ser aninhadas, os caracteres comuns de HTML são escapados e os aninhamentos incorretos são informados em vez de gerar marcação quebrada silenciosamente. A conversão é determinística, não requer acesso à rede e sempre devolve o mesmo resultado para a mesma entrada.

Converta as tags BBCode compatíveis

O conversor reconhece seis famílias comuns de BBCode: <code>[b]</code>, <code>[i]</code>, <code>[u]</code>, <code>[url]</code>, <code>[quote]</code> e <code>[list]</code>. O negrito vira <code>&lt;strong&gt;</code>, o itálico vira <code>&lt;em&gt;</code>, o sublinhado vira <code>&lt;u&gt;</code>, as citações viram <code>&lt;blockquote&gt;</code> e as listas viram listas HTML não ordenadas com itens. Um link pode usar <code>[url=https://example.com]rótulo[/url]</code> ou <code>[url]https://example.com[/url]</code>. Os itens começam com <code>[*]</code> dentro de uma lista. As tags podem ser aninhadas quando são fechadas na ordem inversa à abertura; assim, um texto em negrito pode conter itálico. Tags fora do conjunto compatível permanecem como texto escapado, sem serem interpretadas como HTML. Esse contrato restrito torna o resultado fácil de entender e evita prometer suporte às muitas extensões incompatíveis usadas por diferentes fóruns. Se a origem depender de tags personalizadas de cor, tamanho, imagem, tabela ou mídia, trate-as separadamente antes ou depois da conversão, com regras adequadas à plataforma de origem.

Entenda a validação e a saída segura

O BBCode reconhecido precisa estar estruturalmente equilibrado. Toda tag de abertura exige a tag de fechamento correspondente, tags aninhadas devem ser fechadas na ordem oposta à abertura e marcadores de itens precisam aparecer diretamente dentro de uma lista. Uma sequência inválida devolve um erro de entrada inválida, não um documento parcial. Isso é importante em publicações automatizadas, pois um reparo silencioso pode deslocar ênfases, links ou citações para além dos limites pretendidos por quem escreveu. Durante a renderização, o texto simples é escapado para HTML, inclusive sinais de menor e maior e ampersands; os destinos dos links também são escapados para uso em atributos. Esquemas URL explícitos são limitados a HTTP, HTTPS e mailto, e fragmentos ou destinos relativos também são aceitos. Essa verificação impede que um link BBCode se torne uma URL de script evidente, mas a saída ainda deve passar pelas políticas de segurança e conteúdo do aplicativo que a incorpora. O conversor transforma sintaxe; ele não substitui um sanitizador HTML específico, um sistema de permissões ou a moderação.

Use o resultado em um fluxo editorial

Envie um valor <code>text</code> e leia a marcação convertida no campo <code>html</code> retornado. Esse formato simples funciona bem em scripts de migração, exportações de fóruns, pipelines de comentários, importações de bases de conhecimento e dados de teste. Antes de converter um arquivo grande, examine registros da plataforma original, pois os dialetos BBCode variam: alguns usam argumentos de listas numeradas, atribuições especiais de citações ou tags proprietárias de mídia que estão deliberadamente fora desta capacidade. Preserve o BBCode original junto com o resultado convertido até revisar a migração, permitindo ajustar o pré-processamento sem perder informações. Em um editor interativo, mostre o erro de tag desequilibrada perto do conteúdo em vez de descartar a formatação. Em uma importação em lote, registre o item com falha e prossiga conforme sua própria política. A conversão pela API custa US$ 0,002 por item. Como não há rede, relógio, aleatoriedade nem serviço externo, a mesma entrada aceita produz HTML equivalente byte a byte em todas as execuções.