Skip to main content

Convert markdown to formatted Notion pages with Mark2Notion

Workflow preview

Workflow preview
100%
Convert markdown to formatted Notion pages with Mark2Notion preview
Open on n8n.io

Important notice

This workflow is provided as-is. Please review and test before using in production.

1. Workflow Overview

Transform markdown text into beautifully formatted Notion pages using the Mark2Notion API. This workflow handles all the complexity of Notion's block structure, including tables, nested lists, code...

Best for

  • Document Extraction automation workflows
  • intermediate n8n builders looking for reusable templates

Tools used

n8n-nodes-base.manualtrigger, n8n-nodes-base.notion, n8n-nodes-base.set, n8n-nodes-base.stickynote, n8n-nodes-base.httprequest

Source and attribution

This workflow is cataloged by N8N Workflows and links back to its original n8n.io source page by Max.

Original n8n.io source

1.1 Workflow description

Title
Convert markdown to formatted Notion pages with Mark2Notion
Workflow name
Convert markdown to formatted Notion pages with Mark2Notion

Transform markdown text into beautifully formatted Notion pages using the Mark2Notion API. This workflow handles all the complexity of Notion's block structure, including tables, nested lists, code blocks, and special formatting.

What this template does

This workflow takes any markdown-formatted text and automatically converts it into properly structured Notion blocks, then appends it to your specified Notion page. It handles all of Notion's API limitations automatically, including:

  • Chunking content over 100 blocks
  • Splitting text over 2000 characters
  • Rate limiting and retry logic
  • Complex table structures
  • Nested lists, including 3+ level of nesting

Use Cases

  • AI Content Publishing: Send ChatGPT, Claude, or other LLM outputs directly to your Notion documentation
  • Form to Documentation: Convert form submissions into formatted project pages
  • GitHub to Notion: Sync issues, PRs, or README files to your team wiki
  • Meeting Notes Automation: Transform transcripts into structured meeting notes
  • Report Generation: Create beautiful reports from data sources

How to use this template

  1. Get your Mark2Notion API key at https://mark2notion.com (free tier includes 100 requests/month)
  2. Create a Notion integration at https://notion.so/my-integrations and copy the token
  3. Add connection to the integration on your Notion page
  4. Copy your page ID from the Notion page URL
  5. Configure the HTTP Request node with your credentials. Use "x-api-key" header name for Mark2Notion Header Auth.
  6. Test with sample markdown to see the result

More Information

1.2 Logical Blocks

This catalog entry is organized from the workflow JSON. The node-level section below shows the executable blocks available for review before importing the template.

2. Block-by-Block Analysis

Block 1 - When you click 'Execute Workflow'

Type / Role
n8n-nodes-base.manualTrigger - manualTrigger
Config choices
Version 1

Block 2 - Create a page

Type / Role
n8n-nodes-base.notion - notion
Config choices
Version 2.2

Block 3 - Set Markdown

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 4 - Sticky Note

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 5 - Sticky Note1

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 6 - HTTP Request - Mark2Notion Append

Type / Role
n8n-nodes-base.httpRequest - httpRequest
Config choices
Version 4.2

Block 7 - Sticky Note2

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 8 - Sticky Note3

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

3. Summary Table

Workflow Convert markdown to formatted Notion pages with Mark2Notion
Complexity intermediate
Nodes 8
Categories Document Extraction
Author Max
Published 06 Sept 2025

4. Reproducing the Workflow from Scratch

  1. 1. Download the workflow JSON

    Use the JSON export at /data/workflows/8331/8331.json as the source template for this automation.

  2. 2. Import the template into n8n

    Open n8n, import the downloaded JSON, and review each node before activating the workflow.

  3. 3. Configure credentials and variables

    Replace placeholder credentials, API keys, webhook URLs, account IDs, and environment-specific values with your own settings.

  4. 4. Test with sample data

    Run the workflow manually or in a staging workspace, inspect node output, and confirm downstream systems receive the expected data.

  5. 5. Activate and monitor

    Enable the workflow only after testing, then monitor executions, errors, and rate limits during the first production runs.

5. General Notes & Resources

Review imported nodes carefully before activation. This catalog entry is intended to help you inspect the workflow structure, understand required services, and find related templates faster.

Node names, credentials, schedules, webhook paths, and external service limits may need adjustment for your workspace.

Frequently asked questions

What does Convert markdown to formatted Notion pages with Mark2Notion do?

Transform markdown text into beautifully formatted Notion pages using the Mark2Notion API. This workflow handles all the complexity of Notion's block structure, including tables, nested lists, code...

What do I need before importing this workflow?

Review the workflow JSON, configure any required credentials in n8n, and test the automation in a safe workspace before using it in production.

Can I customize this workflow?

Yes. Use the block-by-block analysis and the downloadable JSON to inspect each node, then adjust credentials, prompts, schedules, filters, or destinations for your Document Extraction use case.