V2
Markdown Read
Read page content as Markdown.
Markdown Read
Use this endpoint when your integration needs to export page body content as Markdown instead of reading individual block objects. This endpoint only reads content and does not modify the page.
GET /v2/pages/:page_id/content/markdown
| Item | Value |
|---|---|
| Method | GET |
| Path | /v2/pages/:page_id/content/markdown |
| Request body | None |
| Returns | Markdown payload |
| Scope | pages.read + blocks.read |
Permissions
Requires both pages.read and blocks.read.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id |
string | Yes | Page ID. |
Response Example
{
"object": "markdown",
"page_id": "11111111-1111-4111-8111-111111111111",
"markdown": "# Launch Plan\n\nInitial release scope and schedule.",
"updated_time": "2026-04-09T09:30:00.000Z"
}
Behavior
- The endpoint serializes supported page content blocks into Markdown.
- Unsupported or non-textual blocks may be omitted or represented in a lossy Markdown form.
- Use block endpoints when you need exact block-level structure.