Skip to main content
POST
/
api
/
v1
/
notion
/
markdown
Append/convert markdown
curl --request POST \
  --url https://{deployment}/api/v1/notion/markdown \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-Notion-Token: <api-key>' \
  --data '
{
  "page_id": "abc123",
  "markdown": "# Title\n- item one\n- item two"
}
'
{}

Authorizations

​
X-API-KEY
string
header
required

Your deployment's API key (MMK_API_KEY).

​
X-Notion-Token
string
header
required

Your Notion integration token / internal token. Supplied by the caller (not stored server-side).

Body

application/json
​
page_id
string
required
​
engine
enum<string>
default:blocks

blocks = legacy in-process parser; native = Notion native markdown API.

Available options:
blocks,
native
​
markdown
string

Markdown content (required except for native update_content).

​
upload_files
boolean

blocks engine only.

​
pdf_as_file
boolean

blocks engine only.

​
position
object

blocks engine only — insert position.

​
command
string

native engine — explicit command override.

​
content_updates
object[]

native engine — update_content.

​
after
string

native engine — insert_content anchor.

​
content_range
string

native engine — replace_content_range.

​
allow_deleting_content
boolean

native engine pass-through.

Response

Append result

The response is of type object.