---
{
  "id": "platform.doc.content-model-and-lossy-markdown",
  "topic": "doc",
  "title": "Doc 內容模型與 lossy Markdown",
  "locale": "zh-TW",
  "version": "2026-08-03",
  "summary": "get_doc 回傳的 Markdown 是刻意 lossy 的投影；除非接受 rich 格式重置，安全修改應使用 append 或文字錨點格式化。",
  "content": "`get_doc` 回傳 `contentMd` 與如實的 `contentLossy` 布林值。canonical Markdown round trip 保留正規化內容時為 `false`；投影省略 rich-only 格式或不支援的結構時才為 `true`。font family、size、color、underline、alignment、line height、indentation 與 page settings 都無法由 Markdown 表達。把 get 的結果修改後交給 `update_doc` 會全文替換，洗掉被省略的 rich-only 細節。\n\n依意圖選 action：加內容用 `append_content`，非空 Markdown 會轉成 blocks 接在尾端並保留既有 rich content；局部改樣式用 `format_text` 或 `format_block`；只有確定要全文重寫且接受 rich 格式重置時才用 `update_doc`。\n\n支援的 Markdown 子集包含 headings、粗體、斜體、刪除線、code、清單、task list、表格、引用、連結、圖片與分隔線。Underline 無法用 Markdown 表達，必須走 `format_text`。未知 node 會降級成可見 plain text，未知 marks/attrs 會被丟棄，非標準 Markdown 或 HTML 不能繞過 allowlist。\n\nCanonical content 上限為 5 MiB JSON、50,000 nodes、depth 64；action arguments 另有 64 KiB 上限，大文件要分次 append。`contentMd` arguments 與 get result 都會 audit-redact。「invalid document content」屬 `invalid_arguments`，應修正內容而非盲目重試。\n",
  "aliases": [
    "lossy Markdown",
    "contentLossy",
    "全文替換",
    "追加內容",
    "補一段結論",
    "保留 rich 格式",
    "rich formatting loss",
    "Markdown round trip",
    "文件格式遺失"
  ],
  "tags": [
    "doc",
    "markdown",
    "content-model",
    "redaction"
  ],
  "relatedActions": [
    "arinova.doc.get_doc",
    "arinova.doc.update_doc",
    "arinova.doc.append_content",
    "arinova.doc.format_text",
    "arinova.doc.format_block"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/doc/content-model-and-lossy-markdown/"
}
---

`get_doc` 回傳 `contentMd` 與如實的 `contentLossy` 布林值。canonical Markdown round trip 保留正規化內容時為 `false`；投影省略 rich-only 格式或不支援的結構時才為 `true`。font family、size、color、underline、alignment、line height、indentation 與 page settings 都無法由 Markdown 表達。把 get 的結果修改後交給 `update_doc` 會全文替換，洗掉被省略的 rich-only 細節。

依意圖選 action：加內容用 `append_content`，非空 Markdown 會轉成 blocks 接在尾端並保留既有 rich content；局部改樣式用 `format_text` 或 `format_block`；只有確定要全文重寫且接受 rich 格式重置時才用 `update_doc`。

支援的 Markdown 子集包含 headings、粗體、斜體、刪除線、code、清單、task list、表格、引用、連結、圖片與分隔線。Underline 無法用 Markdown 表達，必須走 `format_text`。未知 node 會降級成可見 plain text，未知 marks/attrs 會被丟棄，非標準 Markdown 或 HTML 不能繞過 allowlist。

Canonical content 上限為 5 MiB JSON、50,000 nodes、depth 64；action arguments 另有 64 KiB 上限，大文件要分次 append。`contentMd` arguments 與 get result 都會 audit-redact。「invalid document content」屬 `invalid_arguments`，應修正內容而非盲目重試。