HTML5标注转Markdown再转HTML会丢失吗？转换工具保留技巧

HTML5的``标签用于高亮文本，但Markdown原生不支持`==text==`这类高亮语法（因CommonMark规范未定义），导致多数转换工具（如marked、remark、默认Pandoc）在转HTML时直接忽略或原样输出，造成重点标注丢失；最可靠、兼容性最强的方案是在Markdown中直接嵌入``HTML标签（如`需要强调的内容`），只要转换器未禁用HTML（主流静态站点生成器均默认允许），即可精准保留高亮效果，而GitHub等少数平台虽过滤``，但可通过Lua过滤器等高级手段为Pandoc定制支持——关键在于明确你的转换链路（前端JS库、服务端工具还是CI流程），并针对性适配，而非盲目依赖未经验证的扩展语法。

Markdown 原生不支持 标签，直接写 ==高亮文本== 或其他语法，绝大多数转换工具（如 marked、remark、Pandoc 默认配置）默认不会生成 元素——重点标注在转 HTML 后确实会丢失。

为什么 ==text== 在多数工具里不生效

CommonMark 规范未定义 == 语法；只有少数解析器（如 Typora、Obsidian、Pandoc 启用 --filter pandoc-markup）支持它，且底层仍需映射到 HTML 的 才能渲染为黄色背景。默认情况下，==text== 要么被忽略，要么原样输出为字符串。

• marked：需手动启用 highlight 选项并配合自定义 renderer，否则跳过
• remark + rehype：必须加 remark-gfm（仅支持表格/任务列表等）+ 单独插件如 remark-mark
• Pandoc：==text== 仅在启用 --wrap=none 且输入格式指定为 markdown+definition_lists 等扩展时才可能触发，不稳定

可靠方案：用 HTML 内联标签混写

在 Markdown 文件中直接写 需要强调的内容，只要转换工具未禁用 HTML（绝大多数默认开启），就能原样保留。这是最轻量、兼容性最好的做法。

• GitHub README.md 不支持 渲染（会过滤掉），但 Jekyll、Hugo、VuePress、Docusaurus 等静态站生成器默认允许并渲染
• 若担心 XSS，可在后处理阶段用 DOMPurify 白名单放行 mark 标签
• 避免写成 —— 语义丢失，且部分工具会 strip style 属性

Pandoc 高级用法：用 Lua 过滤器强制转

如果坚持用 ==text== 语法，Pandoc 支持通过 Lua 过滤器实现精准替换。把以下代码存为 mark.lua，然后执行：pandoc --lua-filter=mark.lua input.md -o output.html

function Inlines (inlines)
  local new_inlines = {}
  for i, el in ipairs(inlines) do
    if el.t == 'Str' and i > 1 and inlines[i-1].t == 'Str' and inlines[i-1].text == '=' and i < #inlines and inlines[i+1].t == 'Str' and inlines[i+1].text == '=' then
      table.remove(new_inlines) -- remove previous '='
      table.insert(new_inlines, { t = 'Span', attr = {['class'] = 'mark'}, content = {el} })
      i = i + 1 -- skip next '='
    else
      table.insert(new_inlines, el)
    end
  end
  return new_inlines
end

注意：该脚本只处理相邻的 =text=，不处理嵌套或跨行；实际使用前需根据你的 Pandoc 版本微调（v2.19+ 对 AST 结构有调整）。

真正麻烦的不是语法怎么写，而是你得清楚当前用的转换链在哪一层做解析——是前端 JS 库？服务端 Pandoc？还是 CI 里的 GitHub Action？不同环节对 HTML 和扩展语法的支持粒度差得很远。别假设“写了就有效”。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《HTML5标注转Markdown再转HTML会丢失吗？转换工具保留技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。