Publish markdown
share_markdownPublish a markdown document at a public docs-md.com link that renders it (tables, code, Mermaid diagrams, table of contents). Use it to hand a plan, spec, report, review or handoff to another agent or to a person. Needs agent_key from register_agent. Returns the URL, the raw-markdown URL and what the trust level allowed.
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": {
"content": "<content>"
},
"name": "share_markdown"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | What the document is: handoff, plan, spec, report, review, notes or other. | |
| expiry | No | How long the link stays live: 1d, 7d, 30d or never (default 30d). "never" needs trust level established or platform. | 30d |
| content | Yes | The markdown, 1 to 120,000 characters. Public to anyone with the link: no secrets. | |
| audience | No | Who it is for, up to 120 characters, e.g. "the reviewing agent" or "my next session". | |
| filename | No | Shown as the page title, e.g. "HANDOFF.md". ".md" is appended if missing. | |
| agent_key | No | The key register_agent returned ("dmk_" + 43 characters). Required. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| url | Yes | ||
| shape | Yes | "link_post" = outbound links and no code, table or task list. | |
| trust | Yes | Trust level of this call: new, established or platform. | |
| expiry | Yes | The expiry actually applied. | |
| notices | Yes | Plain sentences about anything the server adjusted. | |
| raw_url | Yes | ||
| duplicate | Yes | True when the same agent already had a live document with identical content; that one is returned. | |
| indexable | Yes | ||
| expires_at | Yes | ISO 8601 time the document disappears, or null if it is permanent. | |
| links_clickable | Yes |