导入文本文件

桌面版 WonderPen 可以将 .txt、.md 文件导入当前文档库，也可以一次导入整个文件夹，保留其中的层级关系。导入会创建新文档，不会修改原始文件。

选择导入入口

先打开要接收内容的文档库，再从顶部的文件菜单选择：

• 导入文本文件：选择一个 .txt 或 .md 文件。
• 导入文本文件夹：选择一个文件夹，批量导入其中及各级子文件夹中的 .txt、.md 文件。

选择后会打开导入设置。在导入到中选择根目录或某篇文档；选择文档时，导入的内容会成为它的下级。确认设置后点击确定，才会开始导入。

Word、PDF 等文件不能通过此入口直接转换为文档；请先用其他工具导出为 TXT 或 Markdown。恢复 WonderPen 文档库的 Zip 备份，请使用备份与恢复中的相应入口。

导入 TXT 与章节切分

导入单个 .txt 文件时，设置中会显示文件名、检测到的编码和导入位置，并默认勾选按章节整理文档。

• 不勾选按章节整理文档：全文导入为一篇文档，以文件名（不含扩展名）作为标题。
• 勾选按章节整理文档：以文件名创建上级文档，将识别出的各章放在它下面。章节标题成为下级文档的标题；第一章之前的前言等内容保存在上级文档正文中。

自动识别与预览

选择自动时，WonderPen 会尝试识别独占一行的章节标题，如 第一章 出发、第 2 回 相遇、Chapter 1 Departure。同一文件的章节标题最好保持一致的写法。

导入前点击预览，检查识别出的章节标题与数量。预览只是检查结果，不会立即导入；关闭预览后，可以继续调整切分规则。

如果预览没有章节，或把正文误认成了标题，请调整标题写法、使用自定义规则，或取消章节整理，先作为一篇文档导入。导入后也可以手动切分章节。

自定义规则

选择自定义后，输入匹配章节标题行的正则表达式。例如，标题为 Part 1 Departure、Part 2 Arrival 时，可以使用：

^\s*Part\s+\d+

直接输入表达式，不要在两端加 /。尽量用 ^ 限定行首，避免正文中提到章节时被误切分；修改后再次预览，确认结果再导入。

导入 Markdown 文件

导入 .md 文件时，会默认勾选解析 Markdown 标记。

• 勾选：把标题、列表、表格、数学公式、代码块等支持的 Markdown 语法转换为编辑器中的相应格式。
• 取消勾选：保留 Markdown 源文本，不在导入时转换格式。

每个 Markdown 文件导入为一篇文档，不按章节切分，也不会根据 Markdown 标题生成目录树中的下级文档。

解析 Markdown 时，文件引用的本地图片也会复制到文档库的附件中。相对路径以 Markdown 文件所在文件夹为起点，因此移动待导入文件时，应保留它与图片的相对位置。网络图片保留原网址，不会自动下载为附件。

如果导入后提示部分图片失败，请检查图片文件是否存在、路径是否正确。建议先导入一篇有代表性的文件，确认格式和图片符合预期，再批量导入。

导入文件夹

选择导入文本文件夹后，可以预览将要创建的目录结构，并选择导入位置。

文件夹及子文件夹会形成文档树的层级，每个文本文件导入为一篇文档。文件夹导入不会逐个 TXT 自动切分章节；若某个 TXT 需要切分，请单独使用“导入文本文件”。

包含 .md 文件时，设置中也会出现解析 Markdown 标记，它只对 Markdown 文件生效。其他类型的文件不会作为文档导入，但 Markdown 引用的本地图片仍按上面的规则处理。

合并关联文档与文件夹

此选项默认开启：如果同一级中有同名的文本文件与文件夹（比较时不含文件扩展名），会合并成一个既有正文、又有下级文档的条目。

例如，原始文件为：

旅行手记/
├── 旅程.txt
├── 旅程/
│   ├── 第一章 出发.txt
│   └── 第二章 抵达.txt
└── 旅途清单.md

• 勾选：旅程.txt 的内容成为“旅程”文档的正文，两章成为它的下级文档。
• 取消勾选：文本文件与文件夹分别导入，目录中会出现两个名为“旅程”的条目。

可以切换这个选项，对照预览中的层级变化。它适合重新导入导出文本文件夹时产生的“正文文件 + 同名子文件夹”结构。

编码与乱码

WonderPen 会尝试自动识别 UTF-8、GBK、GB18030 等常见编码；单文件导入设置会显示识别结果。自动识别并非总是准确，尤其是内容很短或使用少见编码的文件。

如果章节预览或导入后的正文出现乱码，请先在能正确打开原文件的文本编辑器中，将文件另存为 UTF-8，再重新导入。单纯修改文件扩展名不会改变编码。