BBCode转HTML

BBCode转HTML是一款免费工具，可将BBCode片段转换为原始HTML，以便在论坛编辑器之外使用。

为什么要把BBCode转换为HTML？

转换BBCode，可以将论坛常用的标记转换为浏览器、内容管理系统和网页模板能够解析的HTML。BBCode使用[b]、[i]和[url]等方括号标签，而不是HTML元素。

在迁移论坛帖子、排查第三方API返回的内容，或将旧知识库导入只接受HTML而不支持BBCode的平台时，这项功能很实用。如果导入的文本需要与周围的应用程序代码分开检查，也可以在部署前先完成转换。

BBCode并不是一门经过正式标准化的语言。不同论坛程序和插件可以定义自己的标签、属性及嵌套规则。因此，常见格式也许能正常转换，但如果源内容包含剧透框、附件引用或自定义媒体标签等平台专用结构，转换结果可能还需要调整。

如何把BBCode转换为HTML？

在BBCode字段中输入或粘贴源标记，然后在HTML字段中查看转换后的代码。确认元素和链接与预期内容一致后，再将HTML复制到目标位置。

1. 复制完整的BBCode片段，包括开始标签和结束标签。
2. 将其放入BBCode字段，不要替换方括号。
3. 在HTML字段中检查原始转换结果。
4. 对照原帖检查链接、图片、列表和嵌套格式。
5. 在公开页面上呈现不可信的输出之前，先对其进行安全净化。

转换在服务器上运行。你的输入会通过HTTPS传输到服务器，并且不会被存储。

如何理解返回的HTML？

应把结果当作源代码查看，而不是可视化预览。返回的HTML应包含相应元素，用于表示源BBCode中的结构和格式。

一个简单的概念示例如下：

BBCode输入：[b]Release note[/b]

HTML输出：一个包含文本"Release note"的b或strong HTML元素。

另一种常见形式是：

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需要格外注意：属于URL本身的字符，例如空格，可能需要进行百分号编码；对外围HTML属性语法有特殊含义的字符，例如与号和引号，则可能需要进行HTML转义。

• 嵌套错误：[b][i]Text[/b][/i]的标签闭合顺序不正确。正确的嵌套标记应先闭合内层标签。
• 缺少结束标签：如果省略最后的标签，[quote]Text就没有对应的结束标签。
• 自定义标签：[spoiler]、[video]和附件标签在不同论坛软件中可能有不同含义。
• 已有HTML：混在BBCode中的HTML可能会被转义、保留或当作普通文本处理，具体取决于解析器。请仔细检查，不要认为所有解析器都遵循同一规则。
• 输入过长：大型迁移通常更适合分批处理，以便找出并修正处理失败的记录。

空输入没有可供转换的格式结构。如果源内容只是纯文本，不含任何BBCode标签，转换可能意义不大。不过，后续处理HTML时仍可能需要转义<、>和&等字符。

哪些情况下不值得转换？

如果内容只会由已经支持原始BBCode方言的系统读取，就不值得转换。更改格式会增加一道转换步骤，而且可能丢失论坛的自定义行为。

如果系统只是原样存储BBCode，之后仍由同一个论坛引擎呈现，也无须转换。同样，如果生成的HTML只供机器读取，美化或手动调整其排版通常没有多大作用，除非版本控制审查或调试需要格式化代码。

进行批量迁移时，脚本化解析器可能更合适，因为它能对每条记录应用相同的方言规则，并记录失败情况。仅使用正则表达式处理嵌套标记风险较高。应使用能够理解嵌套、属性和格式错误输入的解析器，再分别验证并净化生成的HTML。如果转换后的内容包含嵌入式JSON配置，可以使用JSON验证与美化工具检查这些数据，但它不能验证外围的HTML。

常见问题

转换后的BBCode可以直接发布吗？

不可以。由不可信论坛帖子生成的HTML在呈现之前，应通过采用允许列表机制的HTML净化工具处理。链接、图片、嵌入式媒体，以及本身可能包含类似HTML文本的源内容尤其需要注意。

换行会自动变成HTML段落吗？

不一定。换行的处理方式取决于BBCode解析器和源平台的规则。有些系统会把空行视为段落，有些则会插入换行元素或保留普通空白字符。在迁移大量内容之前，请先使用一段多行示例与原论坛的呈现效果进行比较。

BBCode支持Unicode字符吗？

支持。BBCode可以包含Unicode文本，包括带重音的字符、表情符号和非拉丁文字，因为这些字符属于内容，而不是标签语法。目标页面也必须使用合适的字符编码，通常是UTF-8，否则转换后的文本可能无法正确显示。

可以转换CSV或数据库导出文件中的BBCode吗？

可以，但只应转换字段值，不要转换整个导出文件。CSV的引号和分隔符，以及数据库的转义序列，都属于外层容器格式。如果把它们传入标记转换器，可能会遭到破坏。请保留一份未经修改的备份，并先处理一小批数据，再将转换应用到每一行。

导入HTML前应该检查什么？

应检查一个包含嵌套格式、链接、列表、图片引用，以及源论坛所用自定义标签的样本。确认目标系统接受这些HTML元素和属性，然后按照其要求完成净化或验证，再执行完整导入。