Parchment

Parchment 是什麼？

Parchment 是一個簡單的 SaaS「Notion 替代方案」，以建立並整理獨立頁面與集合為核心。它提供乾淨的 UI，概念上以將內容組織成頁面為中心，集合則作為分組。

Parchment 功能的主要部分是程式化存取：您可以透過 API 管理集合、頁面，以及頁面內的區塊。這適用於想要以程式碼建立、更新並匯出結構化頁面內容的使用者。

集合與頁面（透過 API 動作管理）： 建立、重新命名、列出並刪除集合與頁面，以便程式化控制內容結構。
基於區塊的頁面內容： 頁面由有序區塊組成（例如標題、文字、清單、程式碼、分隔線），您可以新增或取代區塊。
使用 replace_blocks 完整重寫頁面： replace_blocks 會刪除頁面上所有現有區塊，並依序寫入新陣列—適合從頭產生完整頁面。
使用 append_blocks 遞增式編輯： append_blocks 會在頁面末尾新增區塊，不取代現有內容，支持累加式工作流程。
使用 indent_level 的巢狀清單： bullet_list 和 numbered_list 區塊接受 indent_level 整數（0–4）來呈現巢狀清單。
基於 HTML 的區塊格式化： 區塊內容以 HTML 字串儲存；支援的格式包括粗體、斜體、刪除線、連結，以及標準 HTML 標籤的彩色文字。
群組區塊（group / delete_group）： 群組區塊作為子區塊的容器；您先建立群組，再以 group_id 關聯子區塊，並可一次刪除群組（及子區塊）。
定義的區塊類型： 包括 text、heading1/2/3、bullet_list、numbered_list、todo、quote、divider、code 和 group。

建立 API 金鑰 並發送請求至 API 基底 URL：https://theparchment.app/functions/v1/api。
列出或建立結構： 先使用 list_collections 列出集合，再使用對應動作建立集合與頁面（例如 create_collection、create_page）。
使用區塊寫入頁面內容： 使用 append_blocks 在現有頁面末尾新增區塊，或使用 replace_blocks 一次重寫整個頁面。
以 HTML 字串格式化內容： 為每個區塊的 content 提供 HTML 字串，使用支援的標籤（例如 <a href="...">...</a> 的連結）。
必要時使用群組組織： 先建立 group 區塊，再附加以 group_id 參照群組的子區塊；使用 delete_group 移除相關內容。

從結構化資料產生頁面： 使用 replace_blocks 從單一真相來源寫入完整頁面佈局（標題、分隔線、段落、清單）。
建立「僅追加」文件記錄： 使用 append_blocks 在頁面末尾新增區段、更新或項目，而不干擾先前內容。
維護階層式檢查清單： 建立 todo 區塊（核取方塊項目），並使用帶 indent_level 的巢狀 bullet_list/numbered_list 區塊呈現子任務或大綱。
跨多頁管理範本化內容區塊： 程式化建立並重新命名頁面，再插入一致的區塊序列（包括透過 code 區塊類型的程式碼片段）。
透過群組建立可重用區段： 使用群組區塊保持相關區塊在一起，並使用 delete_group 刪除或重新產生整個區段。

Parchment API 使用什麼端點？ API 基底 URL 是 https://theparchment.app/functions/v1/api。
如何驗證請求？ 所有請求需包含 x-api-key 標頭。文件範例顯示 x-api-key: pmt_your_key。
append_blocks 和 replace_blocks 有何差異？ append_blocks 在頁面末尾新增區塊而不取代現有區塊，而 replace_blocks 刪除所有現有區塊並依陣列順序寫入提供的區塊。
區塊內容是純文字還是 HTML？ 區塊內容以 HTML 字串儲存；格式化使用標準 HTML 標籤（例如 <strong>、<i>、<a> 和 <span style="color: ...">）。
巢狀清單如何運作？ bullet_list 和 numbered_list 區塊支援 indent_level 欄位（整數 0–4）來呈現巢狀子清單。