Pandoc3.7新特性:存在合并单元格的 HTML 表格会被保留为嵌入的 HTML 表格

问题描述

在 Pandoc 3.6 中,当将包含合并单元格的 HTML 表格 (<table>) 转换为 Markdown 格式时,表格会被直接转换为 Markdown 表格格式。然而,在 Pandoc 3.7 中,同样的操作结果发生了变化:合并单元格的 HTML 表格被保留为嵌入的 HTML 表格,而不是强制转换为 Markdown 表格。

pandoc的官方文档地址:https://pandoc.org/releases.html


3.7版本文档相关说明

  1. Grid Table 改进:

    • 文档中提到: New version of gridTable (#6344) API change. This handles row and colspans. It also ensures that cells won't wrap text in places where it wouldn't normally wrap, even if this means making the cells wider than requested by the colspec (#9001, #7641).

    这一改动表明 Pandoc 3.7 对网格表格(gridTable)进行了重大升级,增加了对 rowspan 和 colspan 的支持,并且在无法正确布局时会扩展单元格宽度以避免文本换行。

  2. HTML Reader 和 Writer 的改进:

    • 文档中提到: Handle row/colspans in grid tables, and expand cells when it isn't possible to lay them out without breaking string of non-whitespace.

    这一改动明确指出,Pandoc 3.7 在处理表格时会尝试保留 rowspan 和 colspan,并在无法正确布局时扩展单元格,而不是简单地将表格转换为目标格式的表格。

  3. Markdown Writer 的改进:

    • 文档中提到: Avoid spaces after/before open/close delimiters (#10696). E.g. instead of rendering xspace y as x* space *y we render it as x space y.

    这一条针对 Markdown 渲染的细节, 更加注重兼容性和展示效果。


结合上述信息,可以得到 Pandoc 3.7 的以下特性导致了行为变化:

  • Grid Table 的改进 :Pandoc 3.7 引入了新的 gridTable 实现,支持 rowspan 和 colspan,并且在无法正确布局时会保留原始 HTML 表格。
  • HTML Reader 的改进:Pandoc 3.7 在读取 HTML 表格时,能够更好地识别和处理复杂的表格结构(如合并单元格),并尽量保留这些结构。

因此,当使用 Pandoc 3.7 将包含合并单元格的 HTML 表格转换为 Markdown 格式时,Pandoc 会选择保留原始的 HTML 表格结构,而不是强制将其转换为 Markdown 表格。这种行为确保了表格在目标格式中的展示效果更好。

其他格式的文件转换我还没有验证,希望有兴趣的朋友来讨论,

相关推荐
追光者4931 分钟前
我把 55 篇自动化日志翻了一遍:最容易出事的是这 4 个地方
python·自动化运维
2601_9628857232 分钟前
如何用 Python计算 CR能量指标(中间意愿指标)?
开发语言·python
打工仔折腾 AI34 分钟前
LangChain 工具调用实战:从 Tool 定义到 Agent 执行链路拆解
java·前端·人工智能·后端·python·langchain·ai agent 实战
hhb_61843 分钟前
Flask+SQLite实现用户管理接口
python·sqlite·flask
全栈练习生44 分钟前
RAG 准确率保障的体系化方案
python·ai
秋秋小事1 小时前
python 基础知识总结(一)
python
蜗牛互联网1 小时前
Python调用Gemini Structured Outputs实现工单路由门禁
java·开发语言·人工智能·python
TomEval1 小时前
【测AI】第12篇:NLP / CV / 语音 —— 三大 AI 方向速通
人工智能·python·自然语言处理·aigc·测试用例
SEO_juper1 小时前
给网页做可引用性评分:判断内容够不够让 AI 引用(GEO 工具,附代码)
开发语言·人工智能·爬虫·python·seo·独立站
AI直播技术杂谈1 小时前
无人直播中控的硬件底线,旧电脑要满足哪些条件
网络·python·ai·云计算