replace_range_markdown
Replace a Google Docs range with markdown after validating the revision stamp and structural elements, preventing stale writes and accidental loss of tables, images, or footnotes.
Instructions
Replace a document range with compiled markdown.
Use this tool when you need to replace a section of a document with new markdown content. Obtain start_index, end_index, and computed_at_revision from find_sections. The range stamp is validated against the current document revision — a stale stamp raises STALE_RANGE ("re-run find_sections").
The structural guardrail inventories tables, images, chips, and footnotes inside the target range before writing. If the replacement markdown does not account for them the write is refused unless allow_structural_loss=true. A blast-radius check compares structural element counts outside the edited range pre/post; any change there is a hard failure.
Set dry_run=true to validate and preview without writing.
The returned payload (applied, revisions, structural_match, input_blocks/ post_blocks) is itself the confirmation the write landed — it already re-read the document and diffed it against the input. A follow-up read_document to double-check is a redundant round-trip; only re-read if you need the content for a subsequent step.
Errors: STALE_RANGE – range stamp is outdated; re-run find_sections UNSUPPORTED_MARKDOWN – markdown contains an unsupported construct INVALID_INPUT – structural guardrail refused or blast-radius violation INVALID_RANGE – start_index/end_index don't fit the tab's current extent, or the Docs API rejected the write as index-invalid TAB_NOT_FOUND – tab_id not in document REVISION_CONFLICT – document changed mid-call; re-read and retry SUGGESTIONS_PRESENT – tab has pending suggested edits; accept/reject them in the Docs UI first, then retry
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"doc_id": "<doc_id>",
"tab_id": "<tab_id>",
"start_index": "<start_index>",
"end_index": "<end_index>",
"computed_at_revision": "<computed_at_revision>",
"markdown": "<markdown>"
},
"name": "replace_range_markdown"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doc_id | Yes | ||
| tab_id | Yes | ||
| dry_run | No | ||
| markdown | Yes | ||
| end_index | Yes | ||
| start_index | Yes | ||
| computed_at_revision | Yes | ||
| allow_structural_loss | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||