跳到內容

Doc 內容模型與 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_textformat_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,應修正內容而非盲目重試。

arinova.doc.get_doc, arinova.doc.update_doc, arinova.doc.append_content, arinova.doc.format_text, arinova.doc.format_block

Also known as

lossy Markdown, contentLossy, 全文替換, 追加內容, 補一段結論, 保留 rich 格式, rich formatting loss, Markdown round trip, 文件格式遺失


Machine-readable Markdown · Knowledge index

Build a7f47a5ca54ddcf7806cd48b81ce1b9827042766