Notion Markdown Unified icon

Notion Markdown Unified

Convert Markdown to Notion blocks and create them in a page

Create Blocks from Markdown

AI-generated

Overview

This node converts Markdown content into Notion blocks and creates them in a specified Notion page. It is useful for automating the process of transferring formatted Markdown text into Notion, preserving list hierarchies and handling large tables by splitting them if necessary. For example, users can input meeting notes or documentation in Markdown format and have them automatically converted and appended or replaced in a Notion page.

Use Case Examples

  1. Automate creation of project documentation in Notion from Markdown files.
  2. Convert meeting notes written in Markdown into structured Notion blocks for team collaboration.

Properties

Name Meaning
Page ID The ID or URL of the Notion page where blocks will be created.
Markdown Content The Markdown text content to convert into Notion blocks.
Options Additional settings to control how blocks are created, including whether to append or replace existing content, preserve list hierarchy, maximum list nesting depth, maximum table rows per table, and API batch size for requests.

Output

JSON

  • results - Array of created Notion blocks returned from the API.
  • blocksCreated - Total number of blocks created from the Markdown content.
  • batchesProcessed - Number of API batch requests processed to create all blocks.

Dependencies

  • Notion API with valid credentials

Troubleshooting

  • Invalid Notion API credentials will cause the node to throw an error before processing.
  • If the page ID or URL cannot be resolved to a valid Notion page, an error is thrown.
  • Large documents may cause API errors; reducing the API batch size option can help mitigate this.
  • If 'Append to Page' is set to false, existing blocks on the page are deleted before new blocks are created, which may cause data loss if not intended.

Discussion