---
{
  "id": "platform.mindmap.outline-workflows",
  "topic": "mindmap",
  "title": "Mindmap outline 批次工作流程",
  "locale": "zh-TW",
  "version": "2026-08-09",
  "summary": "Markdown heading 或縮排 outline 可有效建立或展開 forest，而完整替換需要確認、具有破壞性且是有損操作。",
  "content": "Mindmap outline 接受兩種方言，每個頂層項目成為獨立 root。ATX heading 用 `#` 表示 roots、`##` 表示 branch，最深 `######`；縮排 outline 每層恰好多 2 個空格，可用 `- `、`* ` 或無 bullet。不可混用方言；空行忽略。無效 heading、奇數縮排、跨層或到達第 64 層會在建立前失敗並指出行號；label 與 2,000-node 上限仍適用。\n\n用 `create_mindmap_from_outline` 把對話、會議記錄或腦力激盪原子地建立成完整 Mindmap。`create_mindmap` 也為相容性接受 `outline`，但 hierarchy 絕不可放進 `description`；多節點 outline 形狀的 description 會在 skeleton 建立前被拒絕。用 `add_subtree` 把一個或多個 outline 頂層項目掛到既有 `parentId` 下，例如展開某個分支。批次建樹應優先使用這些 actions，而不是反覆呼叫 `add_node`。\n\n`replace_outline` 接受包含多個頂層 roots 的 forest。它會刪除所有既有節點，再建立全新的節點與 ID，因此需要使用者確認。Service 會在替換前後各建立 checkpoint；之後可由產品版本歷史復原文件內容，但舊 node ID 不會回來。\n\n`get_mindmap_as_outline` 的 top-level `outline` 字串是只保留 label 與階層的有損投影；同一 response 也包含完整 `mindmap.nodes` 陣列，帶 node ID 與完整欄位，live readback 或需保留 rich content 的局部修改應使用這些 nodes。若只把 outline 字串送進 `replace_outline`，仍會建立新 ID，並抹掉 color、icon、styles、images、linked notes、collapsed、layout side 與 manual offsets。\n",
  "aliases": [
    "Markdown 大綱",
    "批次建樹",
    "掛上 subtree",
    "替換整棵樹",
    "lossy outline"
  ],
  "tags": [
    "mindmap",
    "outline",
    "batch"
  ],
  "relatedActions": [
    "arinova.mindmap.create_mindmap_from_outline",
    "arinova.mindmap.get_mindmap_as_outline",
    "arinova.mindmap.add_subtree",
    "arinova.mindmap.replace_outline"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/mindmap/outline-workflows/"
}
---

Mindmap outline 接受兩種方言，每個頂層項目成為獨立 root。ATX heading 用 `#` 表示 roots、`##` 表示 branch，最深 `######`；縮排 outline 每層恰好多 2 個空格，可用 `- `、`* ` 或無 bullet。不可混用方言；空行忽略。無效 heading、奇數縮排、跨層或到達第 64 層會在建立前失敗並指出行號；label 與 2,000-node 上限仍適用。

用 `create_mindmap_from_outline` 把對話、會議記錄或腦力激盪原子地建立成完整 Mindmap。`create_mindmap` 也為相容性接受 `outline`，但 hierarchy 絕不可放進 `description`；多節點 outline 形狀的 description 會在 skeleton 建立前被拒絕。用 `add_subtree` 把一個或多個 outline 頂層項目掛到既有 `parentId` 下，例如展開某個分支。批次建樹應優先使用這些 actions，而不是反覆呼叫 `add_node`。

`replace_outline` 接受包含多個頂層 roots 的 forest。它會刪除所有既有節點，再建立全新的節點與 ID，因此需要使用者確認。Service 會在替換前後各建立 checkpoint；之後可由產品版本歷史復原文件內容，但舊 node ID 不會回來。

`get_mindmap_as_outline` 的 top-level `outline` 字串是只保留 label 與階層的有損投影；同一 response 也包含完整 `mindmap.nodes` 陣列，帶 node ID 與完整欄位，live readback 或需保留 rich content 的局部修改應使用這些 nodes。若只把 outline 字串送進 `replace_outline`，仍會建立新 ID，並抹掉 color、icon、styles、images、linked notes、collapsed、layout side 與 manual offsets。