Google Docs 匯出 Markdown 指南

多數團隊都在 Google Docs 上寫東西。但只要你想把那些內容放進靜態網站產生器、LLM 的提示、Obsidian 保管庫，或一個以 Markdown 為主的 CMS，就會撞上同一道牆：Docs 沒辦法乾淨地匯出成 Markdown。

這篇指南把每一種方法走過一遍，從最快的（一鍵）到最可控的（用腳本打 API），順便講清楚各自的怪癖。

為什麼要把 Google Docs 匯出成 Markdown？

團隊把 Docs 內容搬出來的常見理由：

• 餵進 AI 工作流 — 給 Claude、ChatGPT 或 Gemini 乾淨的脈絡，不夾帶那些會絆倒 LLM 的排版雜訊
• 發佈到靜態網站 — 現在的網站產生器（Astro、Hugo、MkDocs、Docusaurus、Jekyll）幾乎都吃 Markdown
• 建立個人知識庫 — Obsidian、Logseq、Foam 都是把筆記存成 Markdown 檔
• 逃離編輯器 — 用 Git 管理自己寫的東西，而不是把身家押在 Google 的版本紀錄上
• 封存與備份 — Markdown 是純文字、帶得走，不會因為 Google Workspace 帳號到期就被綁架

方法一：Minibase Chrome 擴充功能（一鍵）

要處理單份文件，Minibase 是最快的路。裝好擴充功能、打開文件、點一下圖示，.md 檔就有了。

Minibase 會抓下來的東西：

• 文件標題與內文，標題層級完整保留（H1–H6 對應 #–######）
• 項目符號與編號清單，含巢狀清單
• 表格，轉成正規的 Markdown 表格
• 內嵌圖片，轉成 Markdown 圖片參照
• 行內註解，掛在原本的錨點位置，並帶上作者與時間
• 粗體、斜體、底線（底線轉成強調）與刪除線
• 從等寬字體判讀出來的程式碼區塊

Minibase 會丟掉的東西：

• Google Docs 的介面外框（工具列、尺規、探索面板）
• 協作者的在線狀態與頭像
• 版本紀錄的介面

它的強項： 單份文件、臨時匯出、以及處理別人只給你檢視權限的內容。免費版儲存次數不限；Minibase Plus 每月 5.99 美元，解鎖 AI 範本、歷史紀錄與影片轉錄。

方法二：Docs 內建的「下載為 Markdown」

Google Docs 在 2024 年底加上了原生的 Markdown 匯出，位置在 檔案 → 下載 → Markdown (.md)。

優點： 免費、官方、不用裝任何東西。

缺點： 有幾個細節會漏掉：

• 註解不會被匯出
• 複雜的表格有時會丟失欄寬與對齊
• 建議模式的修訂會被無聲地攤平
• 圖片指向的是需要驗證身分的 Google 網址（對自架網站來說很糟）

它的強項： 一次性匯出，你不需要註解，也不介意重新上傳圖片。

方法三：Docs-to-Markdown Google Apps Script

要大量匯出，或接進既有的自動化流程，Ed Bacher 的 Docs to Markdown 是經典的開源選擇。它是一支跑在 Docs 裡的 Google Apps Script，會吐出 Markdown 加 HTML。

設定： 大約十分鐘——把腳本貼到 擴充功能 → Apps Script、授權，然後從側邊欄執行。

優點： 免費、可腳本化、處理得了大部分複雜文件，而且註解保得住。

缺點： 需要 Apps Script 權限、介面有點老派，巢狀表格有些邊角案例會出包。

它的強項： 需要定期匯出，但又不能裝 Chrome 擴充功能的情況（例如公司鎖得很死的筆電）。

方法四：Google Docs API ＋自訂流程

要完全的程式化控制，Google Docs API 會把整份文件的結構以 JSON 攤開給你。你可以：

1. 用 OAuth 2.0 或服務帳戶完成驗證
2. 呼叫 documents.get 取得文件結構
3. 走過 body.content 這棵樹，輸出 Markdown

像 google-docs-to-markdown（TypeScript）這類函式庫，已經幫你把走訪的部分寫好了。

優點： 完全可控、能批次匯出、可以接進 CI 流程。

缺點： 驗證要先搞定（OAuth 或服務帳戶）、有速率限制、需要一位工程師。

它的強項： 要按排程匯出上百份文件、要做內部工具、或是把整個 Workspace 遷到靜態網站。

四種方法比一比

方法	速度	費用	圖片	註解	表格
Minibase 擴充功能	⚡ 立即	免費 → 每月 5.99 美元	✅ 有連結	✅ 行內保留	✅ 乾淨
下載為 Markdown	快	免費	⚠️ Google 代管	❌	⚠️ 有點怪
Docs-to-Markdown 腳本	中等	免費	✅	✅	✅
Google Docs API	設定慢	開發工時	看實作	看實作	看實作

AI 引擎要的是什麼

如果你的最終目的是把文件內容餵給 LLM，有幾個地方特別值得留意：

• 保住標題層級。 做 RAG 時，LLM 靠 ## 與 ### 的結構定位到相關段落。
• 表格要維持成 Markdown 表格。 用管線符號分隔的表格，token 效率遠高於被轉成散文的版本。
• 丟掉「編輯紀錄」與審閱討論串。 那是雜訊，只會把脈絡視窗撐爆。
• 註解要留在它的錨點上。 最重要的決定常常就藏在那裡。

Minibase 的擷取正是照這個方向調校的——研究人員、產品經理與開發者每天都用它，把自己的筆記餵給 Claude 或 ChatGPT。

多數團隊最快的做法

如果你要匯出 1～10 份文件，而且現在就想要乾淨的 Markdown：

1. 安裝 Minibase for Chrome
2. 打開每一份文件
3. 點一下 Minibase
4. 完成——把 .md 拖進 Obsidian、Notion、你的儲存庫，或 Claude

如果你要按排程匯出好幾百份文件，就把 Google Docs API 寫進你既有的流程裡。

不管走哪一條，你的內容都重新回到自己手上，而且是每個工具都讀得懂的格式。

---

Minibase 一鍵把任何網頁變成乾淨的 Markdown，直接存進 AI 能搜尋的本機保管庫。擴充功能免費且儲存次數不限；Minibase Plus（每月 5.99 美元或每年 34.99 美元）另有 AI 範本、歷史紀錄與影片轉錄。minibase.md。