Read a Markdown or DOCX document as structured blocks.

Returns headings, paragraphs, list items and tables with stable IDs (h-0, p-1, li-2, tbl-0). Prefer section_id= over reading whole documents. Pass doc_hash from a previous call to detect external modifications. Lists unmodeled_features so you know what the model cannot represent (images, footnotes, ...).

Get the heading outline of a document.

Returns flat heading entries (id, level, title, path) plus a nested tree. Use heading ids to read sections or anchor edits.

Find exact occurrences of text inside document blocks.

Returns every match as (element_id, start, end) character offsets plus a snippet - feed these offsets directly into propose_replace_text. Tables are skipped (cell-level search not supported).

List comments anchored in the document (native DOCX comments).

Each comment carries id, author, body, element_id and quoted range. For Markdown (which has no comment concept) the list is empty.

Stage replacing character range [start:end) inside one block.

Offsets come from find_text or read_document. The staged change includes before/after previews; nothing is written until apply_changes. Table cells are not supported (delete/re-insert the table instead).

Stage inserting a new block before or after an existing element.

position: 'before' | 'after' (relative to anchor_id). kind: 'paragraph' | 'heading' (set level 1-6) | 'list_item'. This single tool covers insert-before, insert-after and append use cases (anchor on the last element and position='after').

Stage deleting one whole block (heading, paragraph, item or table).

Stage adding a comment anchored to an element.

DOCX: creates a real Word comment (visible in Word/Google Docs). Markdown: stored in the session only - surfaced by get_comments until the process exits, because Markdown has no native comment storage; the tool result states this limitation explicitly. quote must appear inside the anchor element.

Review all staged changes with diffs before committing.

Replace changes carry unified diffs; inserts/deletes/comments show their content. Apply selectively with apply_changes(change_ids=[...]).

Drop staged changes (all of them, or specific change ids).

Commit staged changes to the file (all, or selected change ids).

Writes atomically, re-reads the file and returns the new doc_hash plus warnings about unmodeled features present in the document.

Convert the document to another supported format ('markdown'|'docx').

Conversion goes through the normalized model: markdown->docx builds a fresh Word file (headings, lists, tables, comments); docx->markdown serializes parsed blocks back to Markdown. Unsupported pairs raise a clear export_error listing supported conversions.

List registered format backends and their file extensions.