Notion Md Converter

What This Skill Does

The Notion Md Converter is a powerful utility designed for OpenClaw users who want to bridge the gap between local markdown files and the Notion productivity ecosystem. By leveraging the Martian library, this skill parses standard Markdown syntax—including headings, task lists, code blocks, and specialized callouts—and translates them into the specific block structures required by the Notion API. It simplifies the migration process by providing both a programmatic interface for developers and a command-line utility for quick automation tasks.

Installation

To install this skill, run the following command in your terminal within the OpenClaw environment: clawhub install openclaw/skills/skills/charpup/notion-md-converter Once installed, navigate to the directory ~/.openclaw/workspace/skills/notion-md-converter and run npm install to resolve dependencies. Finally, ensure you have a valid Notion API secret and export it as an environment variable: export NOTION_TOKEN="ntn_your_token_here".

Use Cases

This skill is ideal for users who rely on local markdown-based note-taking (like Obsidian or Zettlr) but need to sync data to a Notion workspace for collaboration. Common scenarios include automatically generating daily journal pages, batch-importing project documentation, or converting technical blog drafts into ready-to-publish Notion pages. It is especially useful within the Galatea Journal system for automated archival.

Example Prompts

1. "OpenClaw, take my meeting-notes.md file and convert it into a new Notion page inside my 'Project Alpha' database."
2. "Convert the following markdown content into a Notion page titled 'Project Roadmap' using my default integration token: [paste markdown content]."
3. "Run the md2notion tool on my weekly-report.md file and save it to my Notion workspace using the CLI configuration."

Tips & Limitations

When using the converter, remember that the Notion API enforces a 100-block limit per request; if your document is longer, consider breaking it into smaller segments. Ensure all image URLs within your markdown are publicly accessible, as Notion must be able to resolve them to embed them correctly. While standard formatting works well, deeply nested lists may be flattened to comply with API structure constraints. Always use the callout syntax (e.g., > [!NOTE]) if you want to take advantage of Notion’s rich styling features for warnings and tips.