N2O converts all major Notion block types to Markdown and back. The table below shows how each block type renders in Obsidian and whether it survives a push back to Notion.
Round-trip key:
- ✓ — Full round-trip. Content and formatting preserved in both directions.
- ◑ — Partial. Pulls correctly, but something is lost or changed on push. See notes.
- ↓ — Pull only. Syncs from Notion to Obsidian but is not pushed back.
| Notion Block | Obsidian | Round-trip | Notes |
|---|
| Paragraph | Plain text | ✓ | Bold, italic, links, colors all preserved |
| Heading 1 | # Heading | ✓ | |
| Heading 2 | ## Heading | ✓ | |
| Heading 3 | ### Heading | ✓ | |
| Heading 4 | #### Heading | ✓ | |
| Quote | > text | ✓ | |
| Divider | --- | ✓ | |
| Notion Block | Obsidian | Round-trip | Notes |
|---|
| Bulleted list | - Item | ✓ | Nesting with 4-space indent |
| Numbered list | 1. Item | ◑ | Content preserved; start number and letter/Roman format lost on push |
| To-do | - [x] Item / - [ ] Item | ✓ | Checked state preserved |
| Notion Block | Obsidian | Round-trip | Notes |
|---|
| Callout | > [!type] Title | ✓ | Icon mapped to callout type (see table below) |
| Toggle | > [!info]- Title | ✓ | Collapsible callout; may swap to callout type on push — content is preserved |
| Toggle heading (H1) | > [!h1]- Title | ✓ | Collapsible H1; children included |
| Toggle heading (H2) | > [!h2]- Title | ✓ | |
| Toggle heading (H3) | > [!h3]- Title | ✓ | |
| Notion icon | Obsidian callout |
|---|
| 💡 | tip |
| ⚠️ | warning |
| ❗ | important |
| ℹ️ | info |
| ✅ | success |
| ❌ | failure |
| 📝 | note |
| 🔥 | danger |
| 🐛 | bug |
| 💬 | quote |
| ❓ | question |
| (anything else) | note |
| Notion Block | Obsidian | Round-trip | Notes |
|---|
| Image (uploaded to Notion) | ![[_files/image.png]] | ✓ | Downloaded locally; Notion-hosted copy preserved on push |
| Image (external URL) |  | ✓ | External URL preserved |
| Video (uploaded) | ![[_files/video.mp4]] | ✓ | Downloaded locally |
| Audio (uploaded) | ![[_files/audio.mp3]] | ✓ | Downloaded locally |
| PDF | ![[_files/file.pdf]] | ✓ | Downloaded locally; rendered as link |
| File attachment | ![[_files/file.zip]] | ✓ | Downloaded locally |
| Bookmark | [Title](url) | ✓ | |
| Embed | [Title](url) | ◑ | URL preserved; rich preview not recreated. With Enhanced Metadata enabled, specific embed types are detected: tweets, Google Maps, Figma, Google Drive, GitHub Gist, Miro, CodePen, Replit, Excalidraw |
| Link preview | [Title](url) | ◑ | Auto-expanded URLs (Notion’s link_preview) become bookmarks |
| Notion Block | Obsidian | Round-trip | Notes |
|---|
| Code block | ```language ``` | ◑ | Language tag preserved; caption below block is not pushed back |
| Inline equation | $equation$ | ✓ | |
| Block equation | $$equation$$ | ✓ | |
| Notion Block | Obsidian | Round-trip | Notes |
|---|
| Table | Markdown table | ◑ | Content preserved; “header row” setting is reset to off on push |
| Table of contents | (invisible marker) | ↓ | Stored as metadata comment; not reconstructed on push |
| Notion Block | Obsidian | Round-trip | Notes |
|---|
| Column layout | Sequential content + --- | ◑ | All content preserved; side-by-side arrangement is lost |
| Notion Block | Obsidian | Round-trip | Notes |
|---|
| Child page | [[Page Name]] | ✓ | Wikilink; child pages sync as their own files |
| Link to page | [[Resolved Name]] | ✓ | Resolved from sync state |
| Child database | (preserved in Notion) | ↓ | Inline database views are preserved on push, not re-created |
| Notion Block | Obsidian | Round-trip | Notes |
|---|
| Synced block (original) | Content rendered inline | ◑ | Only the first child block is pushed back — Notion API limitation |
| Synced block (reference) | ![[Page#^block-id]] | ✓ | Obsidian transclusion |
| Notion format | Obsidian | Round-trip |
|---|
| Bold | **text** | ✓ |
| Italic | *text* | ✓ |
| Strikethrough | ~~text~~ | ✓ |
| Inline code | `text` | ✓ |
| Underline | <u>text</u> | ✓ |
| Hyperlink | [text](url) | ✓ |
| Text color | <span class="n2o-color-red">text</span> | ✓ |
| Background color | <span class="n2o-bg-yellow">text</span> | ✓ |
| Page mention | [[Page Name]] | ✓ |
| User mention | @Name | ↓ |
| Date mention | 2026-01-15 | ↓ |
These Notion features are not synced by N2O:
| Feature | Reason |
|---|
| Block-level comments | Notion API does not expose comments on blocks |
| Page-level comments | Not available via the API |
| Page history / version restore | Read-only in Notion API |
| Breadcrumb blocks | Display-only in Notion; no content to sync |
| Template blocks | Notion API does not expose template block contents |
| AI blocks | Not exposed via Notion API |
