Pages

Retrieve a page as markdown

Changed on
get/v1/pages/{page_id}/markdown

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/pages/{page_id}/markdown
  • Auth
    HTTP bearer

Path parameters

page_idstring required

Query parameters

include_transcriptboolean

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.

markdown_version'v1' | 'v2'

The Markdown syntax to use. v1 (the default) is enhanced markdown. v2 is Notion-flavored Markdown, an opt-in preview.

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Response

object'page_markdown' required

The type of object, always 'page_markdown'.

idstring uuid required
markdownstring required

The page content as Markdown, in the syntax set by markdown_version: enhanced markdown (v1, the default) or Notion-flavored Markdown (v2).

truncatedboolean required

Whether the content was truncated due to exceeding the record count limit.

unknown_block_idsIdResponse[] 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.

Changes

  • ed50532d1d7eRevision changes
    • info

      added the new optional query request parameter markdown_version

    • info

      added the optional property to the response with the status

  • c90a4587bc95Revision changes
    • warning

      added the new idempotency_key_reused enum value to the / response property for the response status