HTML5怎么标注重点在Markdown转html会丢失吗_转换工具保留技巧【教程】

2次阅读

markdown原生不支持==text==高亮语法,因commonmark未定义该语法,多数工具默认忽略或原样输出;最兼容方案是直接使用标签,github除外,jekyll等静态站支持。

HTML5怎么标注重点在Markdown转html会丢失吗_转换工具保留技巧【教程】

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

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

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

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

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

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

  • GitHub README.md 不支持 <mark></mark> 渲染(会过滤掉),但 Jekyll、Hugo、VuePress、Docusaurus 等静态站生成器默认允许并渲染
  • 若担心 xss,可在后处理阶段用 DOMPurify 白名单放行 mark 标签
  • 避免写成 <span style="background-color:yellow"></span> —— 语义丢失,且部分工具会 strip style 属性

Pandoc 高级用法:用 lua 过滤器强制转 <mark></mark>

如果坚持用 ==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 和扩展语法的支持粒度差得很远。别假设“写了就有效”。

text=ZqhQzanResources