Skip to main content
write_document_markdown ⚠️ REPLACES ALL existing content with new Markdown-based content. To ADD content to an existing document, use append_markdown_to_document instead. Converts extended Markdown to TipTap JSON server-side — supports ALL HERO node types (headings, @clause, @title, @signature, callouts, columns, tabs, tables, inline atoms, charts, etc.). Call get_hero_writing_guide for the full syntax — an MCP client has no system prompt carrying it, and writing plain Markdown here produces a document with no clauses, terms or placeholders in it. Cross-references to this document’s clauses written as prose (“Section 2”, “Clauses 4.1(a) and (b)”) are linked to their clause automatically. Any left as text come back as unlinkedCrossReferences: a number no clause has, or a clause of another document, which needs create_clause_reference. Lines whose markup could not be read come back as unparsedSyntax; fix those with patch_document. Comments stay on their text; one whose text the edit removed comes back in detachedComments: tell the user. Otherwise the result confirms the write: do not read the document back to check it.

​
Parameters

​
string
required
ID of the document to write.
​
string
required
Full document content in extended Markdown — see get_hero_writing_guide for the syntax.