BBCode para HTML

O BBCode para HTML é uma ferramenta gratuita que converte trechos de BBCode em HTML bruto para uso fora dos editores de fóruns.

Para que serve a conversão de BBCode?

A conversão de BBCode transforma a marcação usada em fóruns em HTML que navegadores, sistemas de gerenciamento de conteúdo e modelos da web conseguem interpretar. Em vez de elementos HTML, o BBCode usa tags entre colchetes, como [b], [i] e [url].

Isso é útil para migrar publicações de um fórum, depurar conteúdo retornado por uma API de terceiros ou preparar uma base de conhecimento antiga para uma plataforma que aceita HTML, mas não BBCode. A conversão também ajuda antes da implantação, quando é preciso verificar o texto importado separadamente do restante do código da aplicação.

O BBCode não é uma linguagem formalmente padronizada. Sistemas de fóruns e plug-ins podem definir as próprias tags, atributos e regras de aninhamento. Por isso, uma conversão que funciona com a formatação mais comum talvez precise de ajustes quando a origem contém recursos específicos da plataforma, como caixas de spoiler, referências a anexos ou tags de mídia personalizadas.

Como converter BBCode em HTML?

Digite ou cole a marcação original no campo BBCode e veja o código convertido no campo HTML. Só copie esse HTML para o destino depois de verificar se os elementos e links correspondem ao conteúdo esperado.

1. Copie o trecho completo de BBCode, incluindo as tags de abertura e fechamento.
2. Cole-o no campo BBCode sem substituir os colchetes.
3. Confira o resultado bruto no campo HTML.
4. Compare links, imagens, listas e formatações aninhadas com a publicação original.
5. Higienize qualquer saída não confiável antes de renderizá-la em uma página pública.

A conversão é executada no servidor. O conteúdo inserido é enviado ao servidor por HTTPS e não fica armazenado.

Como interpretar o HTML retornado?

Leia o resultado como código-fonte, não como uma prévia visual. O HTML retornado deve conter elementos que representem a estrutura e a formatação definidas no BBCode original.

Um exemplo conceitual simples:

Entrada BBCode: [b]Release note[/b]

Saída HTML: um elemento HTML de negrito ou de destaque forte contendo o texto "Release note".

Outro padrão comum:

Entrada BBCode: [url=https://example.org/docs]Read the docs[/url]

Saída HTML: um elemento de âncora cujo destino é https://example.org/docs e cujo texto visível é "Read the docs".

Os nomes exatos dos elementos podem variar entre conversores porque os dialetos de BBCode não são padronizados. Por exemplo, o texto em negrito pode ser representado tanto por um elemento b, que chama a atenção sem transmitir importância adicional, quanto por um elemento strong, que indica grande importância. Confira o valor exibido no campo HTML em vez de pressupor um mapeamento específico.

Esta ferramenta é um conversor, não substitui um validador de HTML nem um higienizador de segurança. Se o resultado trouxer BBCode literal inesperado, conteúdo ausente ou elementos com aninhamento estranho, a origem provavelmente contém uma sintaxe inválida ou não compatível. Entre os problemas mais comuns estão tags sem fechamento, tags de fechamento na ordem errada, atributos malformados e tags específicas de fóruns sem equivalente geral em HTML.

Entradas problemáticas e diferenças entre dialetos

Espaços, sinais de pontuação, números, letras acentuadas e sistemas de escrita não latinos são tratados como texto comum, a menos que apareçam dentro da sintaxe das tags ou dos atributos. Eles devem permanecer como conteúdo, e não se transformar em marcação separada. URLs exigem mais cuidado: caracteres que fazem parte da URL, como espaços, talvez precisem de codificação percentual. Já caracteres com significado especial na sintaxe do atributo HTML ao redor, como o E comercial e as aspas, talvez precisem ser escapados em HTML.

• Aninhamento incorreto: [b][i]Text[/b][/i] fecha as tags na ordem errada. Em uma marcação aninhada corretamente, a tag interna é fechada primeiro.
• Tags de fechamento ausentes: [quote]Text fica sem o fechamento correspondente quando a tag final é omitida.
• Tags personalizadas: [spoiler], [video] e tags de anexos podem ter significados diferentes dependendo do sistema de fórum.
• HTML existente: quando misturado ao BBCode, o HTML pode ser escapado, mantido ou tratado como texto, dependendo do analisador. Verifique-o com atenção em vez de presumir que existe uma regra universal.
• Entrada muito longa: em geral, é mais fácil processar migrações grandes em lotes para identificar e corrigir os registros com falha.

Uma entrada vazia não tem estrutura de formatação para converter. Se a origem for texto simples, sem tags de BBCode, a conversão pode acrescentar pouco valor. Ainda assim, o processamento posterior em HTML talvez precise escapar caracteres como <, > e &.

Quando não vale a pena fazer a conversão?

A conversão não vale a pena quando o conteúdo só será lido por um sistema que já entende o dialeto de BBCode original. Mudar o formato adiciona outra etapa de transformação e pode eliminar comportamentos personalizados do fórum.

Ela também é desnecessária quando um sistema armazena o BBCode sem alterações para renderizá-lo depois com o mesmo mecanismo do fórum. Da mesma forma, embelezar ou reorganizar manualmente o HTML gerado traz pouco benefício quando apenas uma máquina fará a leitura, exceto se essa formatação for necessária para revisões no controle de versão ou para depuração.

Em migrações em massa, um analisador executado por script pode ser mais adequado, pois consegue aplicar as mesmas regras de dialeto a todos os registros e registrar as falhas. Usar apenas expressões regulares é arriscado quando há marcação aninhada. Use um analisador que entenda aninhamento, atributos e entradas malformadas. Depois, valide e higienize separadamente o HTML resultante. Se o conteúdo convertido incluir configurações JSON incorporadas, um Validador e embelezador de JSON pode ajudar a examinar esses dados, mas não valida o HTML ao redor.

Perguntas frequentes

Posso publicar o BBCode convertido diretamente?

Não. O HTML gerado a partir de publicações de fórum não confiáveis deve passar por um higienizador de HTML baseado em uma lista de permissões antes de ser renderizado. Isso é especialmente importante para links, imagens, mídias incorporadas e qualquer origem que já possa conter texto semelhante a HTML.

As quebras de linha viram parágrafos HTML?

O tratamento das quebras de linha depende do analisador de BBCode e das regras da plataforma de origem. Alguns sistemas interpretam linhas em branco como parágrafos, enquanto outros inserem elementos de quebra de linha ou preservam os espaços em branco como texto simples. Compare uma amostra com várias linhas à renderização do fórum original antes de migrar um conjunto grande de conteúdo.

O BBCode aceita caracteres Unicode?

O BBCode pode conter texto Unicode, incluindo caracteres acentuados, emojis e sistemas de escrita não latinos, pois esses caracteres fazem parte do conteúdo, e não da sintaxe das tags. A página de destino também precisa usar uma codificação de caracteres adequada, normalmente UTF-8, ou o texto poderá ser exibido incorretamente depois da conversão.

Posso converter BBCode dentro de uma exportação CSV ou de banco de dados?

Converta os valores dos campos, não o arquivo de exportação inteiro. Aspas de CSV, delimitadores e sequências de escape do banco de dados pertencem ao formato que contém os dados e podem ser danificados se passarem por um conversor de marcação. Guarde um backup sem alterações e processe um lote pequeno antes de aplicar a conversão a todas as linhas.

O que devo verificar antes de importar o HTML?

Verifique uma amostra que contenha formatação aninhada, um link, uma lista, uma referência a imagem e todas as tags personalizadas usadas pelo fórum de origem. Confirme se o destino aceita esses elementos e atributos HTML. Depois, execute a etapa de higienização ou validação exigida antes da importação completa.