🔧 阿川の電商水電行
=========================================================================================================================================================================================================================================================================================================================================================================
想把大型的需求定義書或規格書（例如數百頁的 PDF）交給 AI 閱讀，並自動從中產出系統設計書或提案書等新文件。
通常如此龐大的文件無法由 AI 一次處理完畢。但結合文件導向型 AI「NotebookLM」與 AI 原生 IDE「Antigravity」，就能將龐大的 PDF 有效率地重構為 Markdown 的專案群，讓 AI 代理人完整掌握規格內容後再進行文件產出。
本文示範如何做到「有一個超大型 PDF，請幫我解析並產出這樣的文件」，並附加實務性的工作流程，直到將最終提交格式 Word 檔（.docx）匯出為止。
目標
- 將數百頁規模的 PDF 規格書讀入並以 Markdown 格式文件化。
- 在 Antigravity 中作為專案統合管理，並讓 AI 代理人進行文件產出與修正。
- 將業務流程等圖表轉為 Mermaid，或無縫放置圖片。
- 將產出的 Markdown（包含 Mermaid 圖）由 Antigravity 一鍵轉換為 Word 格式。
前提條件
- 已具備 Antigravity 的基本操作能力。
- 已具備 NotebookLM 的基本操作能力。
- 建議有 Google AI Ultra 的付費方案：若要在實務上處理數十至上百頁的 PDF，免費方案在輸出 token 與上下文視窗限制上會較為吃緊，建議使用付費方案。
本次示範使用的範例 PDF 為日本數位廳公開的「調達仕様書等の概要（2026年3月6日版）」。來源：日本數位廳官方網站。
術語說明
以下簡要說明本文中作為文件管理核心的兩項技術。
- Markdown（標記語言）
- 特性：以純文字方便地撰寫標題、項目符號等結構的標記語言。
- 為何必要：對 AI 代理人來說，Markdown 是最容易讀寫且適合跨文件理解與修改的格式。
- Mermaid（Mermaid 圖表）
- 特性：以文字（像寫程式碼一樣）產生流程圖、時序圖等圖表的語法與工具。
- 為何必要：將圖表當成「文字（程式碼）」處理後，AI 只要用自然語言指示就能修改圖表，極大提升可維護性。
0. 安裝 Antigravity 與必要外掛
首先準備好作為基底的 IDE 環境。
- Antigravity 安裝
從 Antigravity 官方網站 下載對應作業系統的安裝程式並完成安裝。Antigravity 採用類似 VS Code 的 UI，熟悉編輯器的人上手容易。 - 安裝必要外掛
啟動 Antigravity，從左側選單開啟「擴充功能（Extensions）」圖示，搜尋並安裝下列兩個在本工作流程中會用到的外掛。
- Markdown Preview Mermaid Support (作者: bierner)
- 用途：在 Antigravity 的 Markdown 預覽中直接將 Mermaid 程式碼渲染為美觀的圖表。
- Markdown Preview Enhanced (作者: shd101wyy)
- 用途：將完成的 Markdown（含生成的 Mermaid 圖）一鍵匯出為 Word 檔（.docx）。
1. 使用 NotebookLM 將 PDF 分割並轉為 Markdown
若把大型 PDF 一次要求 NotebookLM 輸出完整 Markdown，容易因輸出 token 上限而中斷。解法是先請 AI 產生分割指示清單，再依序處理各段落。
步驟：
- 在 NotebookLM 上傳 PDF，然後執行以下提示詞，請 NotebookLM 根據 token 限制生成能安全輸出的分割指示清單。
請閱讀內容，並為了避免觸及 token 限制，將可以安全輸出的文字量切分成多個段落，輸出一個「Markdown 化指示清單」，每項指示描述要將 PDF 的哪一部分轉成 Markdown（例如：「第 1 章〜第 2 章」或「附錄 A」等）。- 依據 NotebookLM 輸出的清單（例如「第1章〜第2章轉成 Markdown」「第3章轉成 Markdown」），逐項向 NotebookLM 發送轉換請求，讓它輸出對應的 Markdown 文本。
- 將 NotebookLM 輸出的 Markdown 文字複製後，存成 Antigravity 專案資料夾中的 .md 檔案。
（介面截圖省略）
在每個輸出的最後通常會有複製按鈕，按下後貼到 Antigravity 的 Markdown 檔即可。
2. 在 Antigravity 中整合與編輯文件
將多個 Markdown 檔放入 Antigravity 專案後，可使用 Antigravity 的 Agent 功能來建構與修改文件。
在聊天欄以自然語言下達指示，例如：
以本調達規格書的目錄為基礎，請新建一份關於政府雲端整合部分的 API 設計書。Agent 會概覽專案內容，自動產出或修正文件以保持一致性。人員主要負責審核內容與向 Agent 提供指示。
在檔案上按右鍵可以預覽文件。
3. 圖表處理（圖片複製貼上與轉為 Mermaid）
PDF 中的圖表可依用途採兩種方式匯入 Antigravity。
既有圖直接使用
在 NotebookLM 的 PDF 預覽中，對目標圖按右鍵複製，然後在 Antigravity 編輯器中直接貼上。這個動作會自動將圖片存成檔案，並在 Markdown 中產生連結。
結構性圖表轉為 Mermaid
對於業務流程或時序圖等具結構性的圖，建議轉成 Mermaid 程式碼以利維護：
- 在 NotebookLM 中選取圖或相關文字，指示「請將此業務流程以 Mermaid 格式輸出」。
- 將產出的 Mermaid 程式碼貼到 Antigravity 的 Markdown 中。
- 在 Antigravity 的擴充功能中安裝 Markdown Preview Mermaid Support（作者: bierner）。
完成後，Antigravity 的預覽會渲染出 Mermaid 圖。若需修改，只要用自然語言告訴 Agent，例如「請在這個 Mermaid 圖的認證流程中加入使用 My Number 卡（個人號碼卡）的流程」，Agent 會精準地修改程式碼。
至此，連原本只能從圖中取得的資訊也能被 AI 問答或指示使用。
4. 建立從 Markdown 輸出為 Word（.docx） 的環境
若最終需提交 Word 格式，以下在 Antigravity 中建立 Markdown → Word 的一鍵轉換環境。
必要工具安裝
需安裝用於生成圖像的 Node.js（npx）與用於轉檔的 Pandoc。
- Windows：
在較新的 Windows 上，建議用 PowerShell 搭配內建套件管理工具 winget 安裝：
# 安裝 Node.js
winget install OpenJS.NodeJS
# 安裝 Pandoc
winget install JohnMacFarlane.Pandoc若無法使用 winget，或想以安裝程式（.msi）以 GUI 安裝，下面那篇 Qiita 教學整理得相當詳細，可作為參考：
👉 Pandoc 的比較簡單安裝方法（@sky_y）
- macOS：
使用 Homebrew 安裝：
brew install node
brew install pandoc- Ubuntu / WSL：
使用 apt 等套件管理工具安裝：
sudo apt update
sudo apt install nodejs npm pandocAntigravity 設定
- 在 Antigravity 的擴充功能中安裝 Markdown Preview Enhanced（作者: shd101wyy）。
- 重要：為了讓 IDE 辨識新安裝的 npx 與 pandoc 命令路徑，請完整關閉 Antigravity 視窗後再重新啟動。
準備 Markdown 文件
為避免輸出格式錯誤，請在目標 Markdown 檔案的最開頭（第 1 行）加入下列 Front Matter：
---
output: word_document
---執行匯出
- 開啟目標檔案，顯示 Markdown Preview Enhanced 的預覽畫面。
- 在預覽畫面上按右鍵 > Pandoc > docx。
背景作業會由 npx 先將 Mermaid 轉成圖片，最後在同一目錄輸出 Word 檔（.docx）。
1) --- 會變成分隔線（上一行必須是空白）
2) # 會變成一級標題
3) ## 會變成二級標題
4) ### 會變成三級標題
5) **粗體文字**會顯示粗體文字
6) ```當第一行與最後一行會顯示程式碼
7) 請搜尋 Markdown 語法，了解各種格式
