Markdown 工具箱:拆分、合并与格式整理
实用工具 → Markdown 工具 中有 拆分、合并、格式化 三项,适合处理已有的 .md 文件。它们与 Markdown 编辑器 是不同入口:工具箱侧重一次性处理文件,编辑器用于继续编辑、预览和其他导出。
下面以自己编写的“第一课.md”和“第二课.md”为例。每份包含标题、两段正文、一个简单表格和一条公式;不要先用唯一副本试验格式转换。网页版和客户端都会打开相应工具页面,页面组件需要成功加载;不能因为文件在本机,就假定整个工具在断网时都可用。
准备一份可重复检查的样例
把下面内容保存为 UTF-8 的 第一课.md;再复制一份,改标题和正文为第二课。
# 第一课
## 目标
学习面积公式,并记录两种图形的数据。
## 数据
| 图形 | 底 | 高 |
| --- | --- | --- |
| 三角形 | 6 | 4 |
| 平行四边形 | 6 | 4 |
三角形面积为 $S=bh/2$。工具箱读取 Markdown 文本,不会自动把图片附件一起搬入。文档有  这类相对路径时,保留原来的图片目录,下载处理后文件也应放在能找到这些资源的位置。
手机上找不到参数时,先打开紫色菜单按钮。工具页的队列和预览不要当作长期存储,离开前下载结果;下载位置由浏览器或客户端的保存提示决定。
拆分:按标题、长度或大纲提取
- 打开 拆分,上传
.md。在 处理方式 中选 单文件处理 或 批量处理;批量最多 10 个文件。 - 根据目标选择模式:
| 模式 | 操作 | 适合的材料 |
|---|---|---|
| 按标题拆分 | 选择 H1 标题 或 H2 标题 | 已有规范标题的课程、笔记、长文 |
| 按长度拆分 | 选择按字符、内容块或参考 Token,再设置目标长度 | 准备分段阅读或分批处理的文本 |
| 按大纲提取指定片段 | 切到单文件处理,展开大纲并勾选章节 | 只保留一章或少量片段 |
- 需要原文件头元数据时开启 保留 Frontmatter:只在第一份输出保留一次;按大纲或勾选结果提取后一章时,也可把原文文件头带入第一份选中输出。关闭后仅移除文件头,正文前言仍保留。按 文件命名模式 的提示设置名称,
base表示原文件名,001表示序号占位;导出的文件保留一个.md后缀。 - 点击 开始拆分。按标题示例选择 H2 后,应检查“目标”和“数据”等章节是否按预期出现。
- 展开结果的大纲,勾选要查看的章节,点击 查看拆分结果。核对标题、表格和公式是否完整,前言等没有标题的内容也需检查。
- 批量处理 中,下载拆分文件 保存全部结果 ZIP;勾选部分章节后,下载选中章节 保存一份按原文顺序组合的 MD。单文件处理 中,勾选结果并点击 批量下载 得到 ZIP;点选某份结果后,源码区的 导出 保存当前预览的原始分片内容。
按 H1/H2 拆分只在匹配级别的真实标题处切分,标题前的内容留在第一份结果;代码围栏中的 # 不作为章节。字符和参考 Token 是长度目标,完整段落、表格、代码块或公式可能超过目标。按内容块 将标题、段落、表格、代码块等各计一块;参考 Token 使用 cl100k_base,不代表所有模型的精确上限。修改设置后需要重新点击 开始拆分。
下载后在源码及目标 Markdown 编辑器中检查。图片路径会保留,但图片文件不会自动进入 ZIP;跨章节的脚注和引用定义也不会自动复制到每份文件。移动 MD 后要同时维护资源目录和必要的引用。
按标题拆分,或勾选大纲中的指定章节。(操作流程示意)。点击图片可在新标签页放大查看。
同一份样稿,核对实际拆分文件
打开 Markdown 拆分工具,或先从拆分指南的实际样例下载原稿和成品。
这份自编 UTF-8 样稿含 YAML、无标题前言、两章正文、表格、多行公式和代码块。按 H2 拆分得到两份 MD,按顺序连接可还原本例原稿;第一章的小节和代码中的假标题留在第一份。第二章保留 images/chart.png 引用,原图仍需自己放在对应目录。参考 Token 目标 100 的实际成品另附六份 MD,用于检查完整内容块的边界。
重点搜索 PREFACE-KEEP-001、CODE-FENCE-KEEP-001 和 DOCUMENT-END-20261010,再逐项比较公式定界、表格行列及换行。样例验证的是这些实际文件,不代表任意 Markdown 扩展语法都可独立渲染。
合并:把多份笔记排成一份
- 打开 合并,选择“第一课.md”和“第二课.md”。首次最多选择 10 个文件,进入工作区后可继续添加至 20 个。
- 在 文件列表 拖拽调整顺序,按最终阅读顺序排列。选错文件用删除按钮移除。
- 在 合并设置 中逐项选择:
| 设置 | 用法 |
|---|---|
| 分隔符 | --- 添加分隔线;“文件名作为 H1”用源文件名分章;“无分隔”直接连接 |
| 标题规范化 | 标题级别 +1、不变或 -1;已有H1时先预览,避免层级混乱 |
| 生成目录 | 根据合并后标题生成目录,下载后测试链接 |
| 剔除参考文献章节 | 只在确定不需要这些章节时打开,处理后检查是否误删 |
| 去重脚注 / 去重参考锚点 | 多文件有重复引用标记时使用,合并后逐个检查引用指向 |
- 输出格式 先选 Markdown,点击 开始合并。
- “合并结果”显示 已完成 和合并文件数后,点击 下载合并文件。
- 打开下载的
.md,检查第一课在前、第二课在后,目录可跳转,表格列数和公式完整。相对图片路径仍应指向实际资源。
PDF 与 Word 选项的当前边界
选择 PDF 会尝试调用浏览器打印。出现打印窗口时选择“另存为 PDF”,检查分页后保存;这不是直接下载 PDF 的同一种操作。在嵌入工具页或部分客户端环境中,打印窗口可能无法打开,遇到时先下载 Markdown,再到编辑器或其他可打印的 Markdown 应用中预览并保存 PDF。大文档打印卡顿时分批处理。
当前 Word 选项会提示“Word 转换暂未实现”,不能通过这个合并工具取得 DOCX。需要 Word 时先完成 Markdown 合并并下载,再使用支持 Word 导出的编辑流程。
排列文件顺序,选择规则,再下载合并的Markdown。(操作流程示意)。点击图片可在新标签页放大查看。
合并后转 Word:同一份稿件的真实结果
两份自编面积课与运动课讲义各含表格、公式及相同的脚注说明。2026-10-13 在合并工具使用 Markdown 输出、目录与脚注去重默认设置,下载的 796 字节合并 MD 与此前公开版本完全一致;没有 OCR 或翻译任务。
- 两组“本课目标”“数据与公式”仍然存在,第二组目录链接带
-1。这些链接字符串不保证每个目标渲染器都生成相同的标题目标。 - 相同脚注正文合为一个定义,两处引用共用它。内容相同的去重,不代表任意不同内容的同名脚注都已通过本例验证。
- 将合并 MD 放入Markdown 编辑器导出后,原样 Word 的六条目录链接都没有匹配书签;改成标题自身锚点后,六个目标匹配,但脚注返回链接仍缺目标,也没有原生 Word 脚注。
下载实际合并 MD或两份输入、三次 Word 与完整核对包。合并文件数、目录文字和下载完成是不同证据,最终稿仍应在目标软件核对。这个样例没有图片、长文分页或桌面 Word/WPS 交互验收。
格式化:先选规则,再左右对照
中文格式化工具与英文格式化工具目前使用不同的工作区和规则。先看地址栏中的语言路径,再按对应界面的控件操作;切换语言不代表结果逐字相同。
- 选择一个
.md文件,或在入口切换到 粘贴文本。中英文入口本次均只允许单文件选择,没有多文件批量队列。 - 查看左侧 原始内容 / Original Content 和右侧 格式化结果 / Formatted Content。导入后会生成初始结果,先检查已开启的选项。
- 中文工作区提供文本及公式相关的 18 个开关;英文工作区提供标题、列表、代码围栏、数学定界、空行、表格及注释等 7 个开关,并有公式风格选择。按实际输出判断变化,不把另一种界面的设置说明直接套用。
- 用一段含公式、代码、金额和表格的副本对照。发现不希望发生的改动时保留原稿,单独处理已确认属于正文的部分。
- 从右侧标题栏下载格式化结果。左侧也有下载按钮,保存的是原始内容;本页样例的下载均来自右侧。
- 下载仍为
.md,需要再到目标编辑器预览。这个流程不会编译 PDF 或直接生成 Word。
可见高级开关应如何使用
中文界面中的部分高级开关没有独立有效的转换;本次关闭全部 18 个开关后,独立公式和未转义金额仍有变化。不能把“全部关闭”当作原样输出模式,也不能仅凭开启状态认定标题、列表或表格已修复。
英文界面的 7 个开关控制另一套处理。对本页的同一份 Cedar 样稿,全部关闭后下载与原稿逐字节相同;默认设置则改变了金额、代码围栏与表格列数。这个结果仅适用于本例,不代表所有输入都无损。
左右对照原文与结果,确认后复制或下载。(操作流程示意)。点击图片可在新标签页放大查看。
同一份原稿,核对中英文实际下载
2026-10-12,我们分别导入同一份 526 字节的自编 Cedar 样稿,其中包含行内公式、独立公式、aligned 环境、Python 代码、美元金额和两列表格。所有结果都从右侧实际下载,保留了非预期改动,没有把修改后的理想文件冒充原生成品。
| 界面与设置 | 实际字节数 | 这份样稿中的观察 |
|---|---|---|
| 中文默认 | 517 | 代码字符串中的括号被换成美元定界;两个金额间的空格改变 |
| 中文 18 开关全部关闭 | 523 | 代码字符串保持原写法,但独立公式和金额仍变 |
| 英文默认 | 555 | 金额变为数学定界;代码语言标记移到下一行;两列表格多出一列 |
| 英文 7 开关全部关闭 | 526 | 本例与原稿逐字节一致 |
英文默认结果截图。核对的是输出文本中的实际变化,不是推荐的代码或表格写法。
中文界面另用一份仅含正文公式的样稿验证定界转换。实际 MD 在编辑器关闭 AI 补全后检查了三处公式;代码与金额没有放入这份正文样稿。
下载同一份原稿、四份实际 MD 与核对记录(ZIP)。压缩包包含原稿、四份未改写结果、说明和哈希记录;本页没有宣称格式化引擎缺陷已经修复。
需要逐条检查定界写法时,继续看公式定界转换指南。需要 Word 时使用独立的编辑与导出流程,不要把 MD 下载当作 DOCX。
表格怎样整理
当前工具箱没有单独的“表格整理”菜单,格式化工具也不保证自动重建表格。整理 Markdown 表格时,先在左侧源文本或 Markdown 编辑器中检查这三项:
- 表头、分隔行和每一数据行的列数一致。上面的例子每行都是“图形、底、高”三列。
- 表头下一行保留
| --- | --- | --- |,每行不要意外断到下一段。 - 单元格里的
|如需作为文字显示,应按目标 Markdown 渲染器的规则转义;合并单元格或复杂跨行表格应在支持该结构的编辑器中检查。
用编辑器预览表格,再保存 Markdown;如果目标是 Excel 表格,应从文档解析或表格导出的对应功能处理,工具箱没有把这份 Markdown 表格直接导出 XLSX 的步骤。
常见问题与恢复
| 现象 | 处理方法 |
|---|---|
| 中文乱码 | 用文本编辑器将源文件另存为UTF-8,再重新上传 |
| 拆分结果没有章节 | 检查标题是否为 # 标题 或 ## 标题,并选择匹配级别;需要时先在编辑器规范标题 |
| 拆分后图片不显示 | 把图片资源放回相对路径对应位置;ZIP主要是拆分后的文本,不会自动打包原图 |
| 合并后标题层级不对 | 调整标题级别和分隔符,重新合并并检查目录 |
| Word没有下载结果 | 当前Word转换未实现,改选Markdown后下载,再进入支持Word导出的编辑流程 |
| PDF打印没有弹窗 | 先下载Markdown,在能打印的编辑器或浏览器预览中另存PDF |
| 格式化后公式或样式不对 | 保留原稿并逐段比较;中文全部关闭仍可能转换,英文行为另看本页实测 |
| 某个开关似乎没有变化 | 对照实际输出;部分可见高级选项尚未实现独立转换,必要时手动编辑 |
| 刷新后找不到结果 | 重新上传原文件处理;今后关闭工具前先下载,不把临时队列当作本机文件库 |

