Skip to contentnotionic
Docs menu

Reference

Supported blocks

How each Notion block renders.

BlockRenders as
Text<p>, with line breaks
Headings 1–4<h2>–<h5> with anchors; toggleable headings as <details>
Lists and to-dos<ul>, <ol> (numbers, letters or roman) and disabled checkboxes
Quote, callout, divider<blockquote>, a bordered box with the icon, <hr>
Toggle<details>
TabsTabs without JavaScript: a row of pills that scrolls sideways, and one panel at a time
Table of contentsLinks to every heading
Code and equationsTheir source as text
Table, columns<table> with headers that scrolls sideways when wide; columns side by side when their container has room, stacked otherwise
Image, video, audio<img> with a subtle outline, a YouTube embed or <video> (for uploaded and linked video files), <audio>
BookmarkA card with the page's title, description and image, from fetchBlocks; the image moves on top when the card is narrow. A one-line card with the URL when there's no preview
File, PDFA card with the file's name and type, and the caption below
Embed, link previewA card like a bookmark's, from fetchBlocks. An embed whose URL ends in /demos/<name> renders one of your demos
Child page, link to pageA row with the page's icon and title, from fetchBlocks
Synced blockIts content

Unsupported blocks, such as breadcrumbs and child databases, render nothing, with a warning in development.