Supported Notion Blocks
Notipo converts your Notion content into WordPress Gutenberg block HTML. Below is a complete reference of every Notion block type and inline formatting that Notipo supports, along with how each maps to WordPress.
Block Types
These Notion block types are fully converted during sync:
| Notion Block | WordPress Output | Notes |
|---|---|---|
| Paragraph | wp:paragraph | All inline formatting preserved |
| Heading 1 | wp:heading (h1) | Inline formatting preserved |
| Heading 2 | wp:heading (h2) | Inline formatting preserved |
| Heading 3 | wp:heading (h3) | Inline formatting preserved |
| Bulleted List | wp:list (ul) | Consecutive items grouped into a single list block |
| Numbered List | wp:list (ol) | Consecutive items grouped into a single list block |
| Code | wp:code / wp:prismatic/blocks | Language detected automatically. Output format depends on your highlighter setting |
| Image | wp:image | Notion S3 images are uploaded to your WordPress media library and cached. Captions preserved as alt text |
| Quote | wp:quote | Multi-line quotes supported |
| Divider | wp:separator | Horizontal rule |
| Table | wp:table | Header row and body rows converted. Inline formatting in cells |
Inline Formatting
Rich text annotations within any supported block are preserved:
| Notion Formatting | WordPress HTML |
|---|---|
| Bold | <strong> |
| Italic | <em> |
| Strikethrough | <del> |
| Inline Code | <code> |
| Link | <a href="..."> |
Database Properties
In addition to page content, Notipo reads these Notion database properties to configure the WordPress post:
| Property | Type | WordPress Mapping |
|---|---|---|
| Name | Title | Post title |
| Status | Select | Controls the publish pipeline (see Publishing) |
| Category | Select | WordPress category |
| Tags | Multi-select | WordPress tags |
| Slug | Rich text | WordPress URL slug |
| SEO Keyword | Rich text | Rank Math focus keyword |
| Featured Image Title | Rich text | Text overlay on the generated featured image |
Not Yet Supported
The following Notion block types are not currently converted. They will be silently skipped during sync:
- Toggle — collapsible sections
- Callout — highlighted info boxes
- Bookmark — URL preview cards
- Embed — embedded content (videos, tweets, etc.)
- Table of Contents — auto-generated TOC
- Child Page — nested Notion pages
- Child Database — inline databases
- Synced Block — references to blocks on other pages
- Column Layout — side-by-side columns
- Equation — LaTeX math expressions
Support for additional block types is being added over time. If a block type you need is missing, let us know.
Tips
- Always specify a language in Notion code blocks for proper syntax highlighting
- Use Notion's built-in image upload rather than external URLs to ensure images are cached in your WordPress media library
- Keep headings sequential (H1 → H2 → H3) for proper document structure and SEO
- If you use unsupported blocks, place the important content in a supported block type as a fallback