---
{
  "id": "platform.doc.formatting-and-page-layout",
  "topic": "doc",
  "title": "文字錨點格式化與頁面設定",
  "locale": "zh-TW",
  "version": "2026-07-24",
  "summary": "Doc 格式化以 exact visible-text anchor 定位；頁面設定則是經驗證的 partial merge，結果要從 metadata 而非 Markdown 確認。",
  "content": "`format_text` 以 exact `matchText` substring 錨定單一 paragraph 或 heading，也包含清單內段落；`occurrence` 是依文件掃描序的 1-based 計數。錨點不能跨 block。`format_block` 只改第一個含 `matchText` 的 paragraph 或 heading；要改多個 blocks 必須多次呼叫並使用更精準的錨點。\n\n若回傳「matchText was not found in the document」，不得宣稱成功。先讀取最新 Doc，在 lossy Markdown 投影中檢查實際 visible text 與空白，再換更長且唯一的 anchor。格式錨點會 audit-redact。文字 `style` 或 block `attrs` 至少要有一個欄位；font、size、color、highlight、alignment、line-height 與 indent 的限制以 live registry schema 與 runtime validation 為準，本卡不抄 enum。\n\n`set_page_settings` 是 partial merge：只覆寫提供的 keys，空物件無效。預設為 A4 portrait、四邊 25.4 mm、header/footer 空白、page numbers 關閉。Header/footer 各最多 500 characters，margins 為 0–60 mm；違規回 `invalid_arguments`。\n\nPage settings 影響列印或匯出呈現，但 `get_doc` Markdown 不會反映。應從 metadata `pageSettings` 確認有效值，而不是查看 `contentMd`。\n",
  "aliases": [
    "format text",
    "format block",
    "matchText",
    "page settings",
    "頁碼",
    "邊界",
    "文字對齊",
    "字型",
    "頁面設定"
  ],
  "tags": [
    "doc",
    "formatting",
    "page-layout",
    "anchors"
  ],
  "relatedActions": [
    "arinova.doc.get_doc",
    "arinova.doc.set_page_settings",
    "arinova.doc.format_text",
    "arinova.doc.format_block"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/doc/formatting-and-page-layout/"
}
---

`format_text` 以 exact `matchText` substring 錨定單一 paragraph 或 heading，也包含清單內段落；`occurrence` 是依文件掃描序的 1-based 計數。錨點不能跨 block。`format_block` 只改第一個含 `matchText` 的 paragraph 或 heading；要改多個 blocks 必須多次呼叫並使用更精準的錨點。

若回傳「matchText was not found in the document」，不得宣稱成功。先讀取最新 Doc，在 lossy Markdown 投影中檢查實際 visible text 與空白，再換更長且唯一的 anchor。格式錨點會 audit-redact。文字 `style` 或 block `attrs` 至少要有一個欄位；font、size、color、highlight、alignment、line-height 與 indent 的限制以 live registry schema 與 runtime validation 為準，本卡不抄 enum。

`set_page_settings` 是 partial merge：只覆寫提供的 keys，空物件無效。預設為 A4 portrait、四邊 25.4 mm、header/footer 空白、page numbers 關閉。Header/footer 各最多 500 characters，margins 為 0–60 mm；違規回 `invalid_arguments`。

Page settings 影響列印或匯出呈現，但 `get_doc` Markdown 不會反映。應從 metadata `pageSettings` 確認有效值，而不是查看 `contentMd`。