Docs menu
Reference
Supported blocks
How each Notion block renders.
| Block | Renders 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> |
| Tabs | Tabs without JavaScript: a row of pills that scrolls sideways, and one panel at a time |
| Table of contents | Links to every heading |
| Code and equations | Their 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> |
| Bookmark | A 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, PDF | A card with the file's name and type, and the caption below |
| Embed, link preview | A card like a bookmark's, from fetchBlocks. An embed whose URL ends in /demos/<name> renders one of your demos |
| Child page, link to page | A row with the page's icon and title, from fetchBlocks |
| Synced block | Its content |
Unsupported blocks, such as breadcrumbs and child databases, render nothing, with a warning in development.