从 Markdown（Obsidian）与 Word 导入
大多数作者并不是从 Scribe 起步写稿。他们通常先在自己已经信任的工具 里写作 —— Obsidian 库、一堆纯 Markdown 文件，或一份积累了几十年使用 习惯、三十多章的 Microsoft Word 文档。本教程演示两条最常见的迁移 路径，目标是得到一个干净的 Scribe 项目：
- A 部分 —— Markdown / Obsidian → Scribe
- B 部分 —— Word（
.docx）→ Scribe
两部分的最终状态相同：一个结构规整的 Scribe 项目，章节以独立的
Markdown 文档管理，图片放在 assets/ 下，并可按文件树顺序与编译范围
进入实时预览与导出流程。
长篇稿件每部分大约需要 30 分钟。
开始之前
您需要准备：
- 一份完稿或在写的稿件，Markdown / Obsidian 或 Word 格式皆可，
- 已安装并登录的 Scribe（任意套餐；导入用 Free 已足够），
- 原始文件夹或
.docx的备份。
开始前请备份源文件夹或 .docx。导入不会替代源文件备份。请先确认导入
内容无误，再决定后续在哪个位置继续维护稿件。
A 部分 —— Markdown / Obsidian → Scribe
A1. 创建一个空的 Scribe 项目
- 打开 Scribe，在欢迎界面选择新建项目。
- 在系统文件夹选择器中，新建或选择一个以稿件命名的空文件夹。
- Scribe 会将该文件夹作为空 Project 打开。
在准备导入前，请先把源稿件保留在该文件夹之外。
A2. 导入文件夹与文件
大多数 Obsidian 库与 Markdown 稿件文件夹本就接近 Scribe 项目的结构：
my-novel/
├── 01-opening.md
├── 02-encounter.md
├── 03-rising.md
└── images/
├── map.png
└── chapter-3-divider.png
在新的 Scribe Project 中，从左侧文件树操作栏选择导入 > 导入文件夹。
Scribe 会一次处理 .md、.markdown、.txt、
.docx，并在可能时保留原有文件夹层级。
如果您想手动整理，也可以把章节 Markdown 放入稿件文件夹，并将图片集中到
assets/。Scribe 会检测新文件并刷新文件树。
A3. 检查名称、结构与 front matter
文件夹导入会以文件名作为 Scribe 文档名称的基础。继续操作前，请检查导入后 的文档名称、层级与正文结构。
Obsidian 的 YAML front matter 不会自动写入项目设置。请检查 tags、
cssclass、publish 等字段，并按稿件需要保留、改写或删除。书籍与出版
信息请另行填写到项目设置中。
A4. 改写 Obsidian 专属语法
Obsidian 在 Markdown 之外加了一些扩展，Scribe 不会原生解析。建议 每个项目一次性决定每种用法的归宿：
| Obsidian 语法 | Scribe 中推荐的替代 |
|---|---|
[[Internal link]] | 普通链接 [Internal link](./other-chapter.md)；如果不是真正的交叉引用，把标题写成斜体也可。 |
[[Image.png]] 嵌入 | 标准 Markdown 图片 。 |
![[Note#Heading]] 引用 | 手动将相关内容复制到稿件中。Scribe 不会自动插入所链接笔记的内容。 |
==highlight== | 改为 *emphasis* 或删除。高亮在印刷中无意义。 |
%%comment%% | 标准 HTML 注释 <!-- comment -->。 |
Callouts（> [!note]） | 改为普通引文，或删掉标记行只保留正文。 |
简单的两遍式流程：
- 在系统中用一款支持跨文件查找替换的文本编辑器（VS Code、Sublime、 BBEdit、Neovim）打开项目文件夹。
- 按上表的顺序，从破坏性最小的开始执行替换。
不必在打开 Scribe 之前修完所有链接 —— 失效链接不会让任何东西崩溃， 只会以纯文本形式显示。您可以在通读时逐步清理。
A5. 检查章节顺序
当章节都已显示在文件树中后，请拖动调整为预期的阅读顺序，并打开几篇文档 确认内容正确。
A6. 填写项目元数据
此时正适合认真填写左侧栏中的项目设置：标题、副标题、作者、 语言、描述，以及需要时的 EPUB 封面。这些信息会用于 EPUB 导出与短代码， 现在做好可省去日后重复工作。
B 部分 —— Word（.docx）→ Scribe
Scribe 可以直接导入 .docx。请先在 Word 中整理样式，再用
文件 > 导入文档…导入单个文件，或用导入 > 导入文件夹处理一个
文件夹。DOCX 导入可保留常见文本结构，但不会重现完整的 Word 版式。
B1. 先整理 Word 文档
在 Word 中做少量整理，会让导入后的 Markdown 好读许多：
- 接受所有修订（Track Changes），
- 删除评论，
- 规范样式：章节标题用 Word 中的标题 1，场景分隔用标题 2或 三颗居中星号，正文使用默认正文样式，
- 删除章节内部的所有分页符；Scribe 根据结构自动分页，而不是依靠 手工放置的分页符，
- 保留仍需使用的图片说明文字。图片需要在导入后重新添加，且 Scribe 当前 没有单独的图片说明文字字段。
B2. 导入 .docx
单一 Word 文档请使用文件 > 导入文档…。如果您的书已经拆成多个
.docx 章节文件，请选择导入 > 导入文件夹。
导入后，先在预览中检查：
- 标题、段落、粗体、斜体、链接、列表、引用与代码是否按预期排列；
- 场景分隔是否保留在正确位置；
- 表格、图片、脚注和尾注是否需要重新添加或改写。
B3. 需要时按标题拆分
导入长文档前，如果希望每个一级标题分别成为 Scribe 文档，请启用 按 # 大标题分割文档。长篇作品拆成多个文档后，文件树排序、编译范围 与导出范围都更容易管理。
B4. 清理导入痕迹
Word 文档往往积累了很久的格式习惯，导入后建议快速检查：
- 碎片化段落 —— 如果有段落仍显得别扭，用查找替换删除段落内的 软换行。
- 智能引号 —— 导入流程通常会保留 Word 中的弯引号。这很好，不要"修" 成直引号。
- 书签锚点 —— 删除不需要的 anchor，保留稿件中实际交叉引用到的。
- 行内样式 —— Word 字符样式可能无法与 Markdown 一一对应。请按合适
情况替换为普通
*斜体*或**粗体**。 - 表格 —— 必要时改写为普通段落、列表或图片。
- 图片 —— 通过**插入图片 > 从磁盘导入…**重新添加。
B5. 偏好 pandoc 时
如果您的团队偏好 CLI 或需要批量转换，也可以使用 pandoc
先将 .docx 转成 GitHub-Flavoured Markdown，再按 A 部分的 Markdown 导入流程处理。
这条路径适合大量文件转换，或需要在 Scribe 之外先审查转换结果的情况。
您学会了什么
- 如何把 Obsidian 库映射为 Scribe 项目布局。
- 如何中和 Scribe 不解析的 Obsidian 专属语法。
- 如何导入 Word
.docx、检查保留的文本结构，并重新添加不受支持的内容。 - 如何整理元数据、图片与编译顺序，让 Scribe 的后续流程顺畅运行。
下一步
- 编辑器 → 基础 —— 快捷键与 命令面板，加速编辑。
- 编辑器 → 图片 —— Scribe 的 图片导入、行内 / 整页与适配设置。
- 教程 → 印刷级 CMYK PDF —— 稿件进入 Scribe 之后，自然的下一步是准备按需印刷文件。