---
title: "Retrieve a page as markdown"
method: GET
path: "/v1/pages/{page_id}/markdown"
tags: ["Pages"]
---

# Retrieve a page as markdown

`GET /v1/pages/{page_id}/markdown`

## Path parameters

- `page_id` string, required

## Query parameters

- `include_transcript` boolean — Whether to include meeting note transcripts. Defaults to false. When true, full transcripts are included; when false, a placeholder with the meeting note URL is shown instead.

## Headers

- `Notion-Version` '2026-03-11', required

## Response `200`

- PageMarkdownResponse
  - `object` 'page_markdown', required — The type of object, always 'page_markdown'.
  - `id` string, uuid, required
  - `markdown` string, required — The page content rendered as enhanced Markdown.
  - `truncated` boolean, required — Whether the content was truncated due to exceeding the record count limit.
  - `unknown_block_ids` IdResponse[], required — Block IDs that could not be loaded (appeared as <unknown> tags in the markdown). Pass these IDs back to this endpoint to fetch their content separately.

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

---

[API](https://skmtc.net/notion/apis/notion-api.md) · [All operations](https://skmtc.net/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notion/notion-api/revisions/551da43bb186/schema)