從 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 之後，自然的下一步是準備按需印刷檔案。