Sign in
Pages

Retrieve a page as markdown

get/v1/pages/{page_id}/markdown

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.

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 rendered as enhanced Markdown.

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

Changed in 5 of the 19 revisions of this API.181

  • c90a4587bc951See the full diff
    • ●

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

      response-property-enum-value-added

  • ae20477af71b11See the full diff
    • ▲

      added subschema #1 subschema #2 subschema #3 to the response body oneOf list for the response status

      response-body-one-of-added

    • ○

      removed subschema #2 from the response body allOf list for the response status

      response-body-all-of-removed

  • 28d140865fc62See the full diff
    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

  • 301eea0116d92See the full diff
    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

  • 681ee94f046c3See the full diff
    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added