BBCode в HTML

BBCode в HTML, это бесплатный инструмент, который преобразует фрагменты BBCode в исходный HTML для использования вне форумных редакторов.

Зачем преобразовывать BBCode?

Преобразование BBCode переводит форумную разметку в HTML, понятный браузерам, системам управления контентом и веб-шаблонам. Вместо элементов HTML в BBCode используются теги в квадратных скобках, например [b], [i] и [url].

Это пригодится при переносе публикаций с форума, отладке контента, полученного через сторонний API, или подготовке старой базы знаний для платформы, которая поддерживает HTML, но не BBCode. Инструмент также поможет перед развёртыванием, если импортированный текст нужно проверить отдельно от остального кода приложения.

BBCode не является единым официально стандартизированным языком. Форумные платформы и плагины могут определять собственные теги, атрибуты и правила вложенности. Поэтому преобразование обычного форматирования может работать правильно, а конструкции конкретной платформы, например блоки со спойлерами, ссылки на вложения или пользовательские медиатеги, потребуют дополнительной настройки.

Как преобразовать BBCode в HTML?

Введи или вставь исходную разметку в поле BBCode. Преобразованный код появится в поле HTML. Копируй его в целевую систему только после того, как убедишься, что элементы и ссылки соответствуют исходному содержимому.

1. Скопируй весь фрагмент BBCode вместе с открывающими и закрывающими тегами.
2. Вставь его в поле BBCode, не заменяя квадратные скобки.
3. Проверь исходный код результата в поле HTML.
4. Сравни ссылки, изображения, списки и вложенное форматирование с исходной публикацией.
5. Очисти результат из ненадёжного источника перед его отображением на общедоступной странице.

Преобразование выполняется на сервере. Введённые данные передаются на него по HTTPS и не сохраняются.

Как читать полученный HTML?

Рассматривай результат как исходный код, а не как визуальный предпросмотр. Полученный HTML должен содержать элементы, которые передают структуру и форматирование исходного BBCode.

Простой условный пример:

Входные данные BBCode: [b]Release note[/b]

Результат HTML: элемент HTML для жирного начертания или выделения важного текста, содержащий текст "Release note".

Ещё один распространённый вариант:

Входные данные BBCode: [url=https://example.org/docs]Read the docs[/url]

Результат HTML: элемент ссылки с адресом https://example.org/docs и видимым текстом "Read the docs".

Конкретные имена элементов могут различаться, поскольку конвертеры работают с разными нестандартизированными диалектами BBCode. Например, жирный текст может быть представлен элементом b, который визуально выделяет фрагмент без указания на его особую важность, или элементом strong, обозначающим высокую значимость. Не рассчитывай на конкретное соответствие тегов, всегда проверяй фактический результат в поле HTML.

Этот инструмент выполняет преобразование, но не заменяет валидатор HTML или средство очистки небезопасного кода. Если в результате остался BBCode в исходном виде, пропала часть содержимого или элементы имеют странную вложенность, вероятно, исходная разметка содержит ошибки или неподдерживаемый синтаксис. Среди типичных проблем встречаются незакрытые теги, неправильный порядок закрывающих тегов, некорректные атрибуты и специфичные для форума теги без универсального аналога в HTML.

Проблемные входные данные и различия диалектов

Пробелы, знаки препинания, цифры, буквы с диакритическими знаками и символы нелатинских письменностей считаются обычным текстом, если они не входят в синтаксис тегов или атрибутов. Они должны оставаться частью содержимого, а не превращаться в отдельную разметку. С URL нужно быть внимательнее. Символам, входящим в адрес, например пробелам, может потребоваться процентное кодирование. Символы со специальным значением в синтаксисе атрибутов HTML, включая амперсанды и кавычки, может потребоваться экранировать средствами HTML.

• Неправильная вложенность: в [b][i]Text[/b][/i] теги закрыты в неверном порядке. При правильной вложенности сначала закрывается внутренний тег.
• Нет закрывающего тега: у [quote]Text отсутствует закрывающая часть, если последний тег пропущен.
• Пользовательские теги: значения [spoiler], [video] и тегов вложений могут различаться в разных форумных системах.
• Готовый HTML: HTML, смешанный с BBCode, в зависимости от парсера может быть экранирован, сохранён без изменений или обработан как текст. Внимательно проверяй результат и не полагайся на универсальное правило.
• Очень большой объём данных: крупные массивы обычно удобнее переносить частями, чтобы можно было найти и исправить записи с ошибками.

В пустых входных данных нет структуры форматирования, которую можно было бы преобразовать. Если исходник представляет собой обычный текст без тегов BBCode, такое преобразование почти ничего не даст. При этом на следующих этапах обработки HTML всё равно может потребоваться экранирование таких символов, как <, > и &.

Когда преобразование не имеет смысла?

Преобразование не нужно, если контент будет читать только система, которая уже поддерживает исходный диалект BBCode. Смена формата добавляет ещё один этап обработки и может привести к потере особого поведения форумных элементов.

Оно также не требуется, если система хранит BBCode без изменений, чтобы позднее отобразить его с помощью того же форумного движка. Аналогично, форматирование или ручная перестройка сгенерированного HTML почти бесполезны, если код будет читать только машина. Исключение составляют случаи, когда удобное оформление требуется для проверки изменений в системе контроля версий или для отладки.

При массовом переносе лучше использовать скриптовый парсер. Он сможет применять одинаковые правила диалекта к каждой записи и вести журнал ошибок. Одни только регулярные выражения ненадёжны при работе с вложенной разметкой. Используй парсер, который понимает вложенность, атрибуты и некорректные входные данные, а затем отдельно проверь и очисти полученный HTML. Если преобразованный контент содержит встроенную конфигурацию JSON, инструмент «Проверка и форматирование JSON» поможет проверить эти данные, но не сам окружающий HTML.

Часто задаваемые вопросы

Можно ли сразу публиковать HTML, полученный из BBCode?

Нет. HTML, созданный из ненадёжных форумных публикаций, перед отображением нужно обработать средством очистки с белым списком разрешённых элементов. Это особенно важно для ссылок, изображений, встроенных медиа и любых исходных данных, которые уже могут содержать текст, похожий на HTML.

Переносы строк превратятся в абзацы HTML?

Обработка переносов строк зависит от парсера BBCode и правил исходной платформы. Одни системы считают пустые строки границами абзацев, другие добавляют элементы переноса строки или сохраняют обычные пробельные символы. Перед переносом большой коллекции сравни многострочный пример с тем, как он отображается на исходном форуме.

Поддерживает ли BBCode символы Unicode?

BBCode может содержать текст Unicode, включая буквы с диакритическими знаками, эмодзи и нелатинские письменности, поскольку эти символы относятся к содержимому, а не к синтаксису тегов. На целевой странице также должна использоваться подходящая кодировка, обычно UTF-8. Иначе после преобразования текст может отображаться неправильно.

Можно ли преобразовать BBCode внутри экспорта CSV или базы данных?

Преобразовывай значения отдельных полей, а не весь экспортированный файл. Кавычки CSV, разделители и управляющие последовательности базы данных относятся к формату контейнера и могут быть повреждены при обработке конвертером разметки. Сохрани резервную копию без изменений и сначала проверь преобразование на небольшой части данных, прежде чем применять его ко всем строкам.

Что проверить перед импортом HTML?

Проверь пример с вложенным форматированием, ссылкой, списком, ссылкой на изображение и всеми пользовательскими тегами исходного форума. Убедись, что целевая система принимает эти элементы и атрибуты HTML, а затем перед полным импортом выполни предусмотренную ею очистку или проверку.