Notion Formatter

What it does

This skill helps format markdown text for optimal import into Notion databases. Notion uses a block-based editor and has limited support for standard Markdown; this tool applies correct syntax for toggles, blockquotes, and code blocks, while also annotating features that require manual recreation within Notion. It supports basic formatting like headers, lists, bolding, italics, and inline code.

When to use it

• Formatting text generated by an AI agent (like a Claude response) for inclusion in Notion databases.
• Converting existing .md files into a format suitable for importing into Notion.
• Dealing with mixed content including images, code, and tables that need specific formatting for Notion.
• Creating multi-section documents using toggles to create collapsible sections within Notion.

Key capabilities

• Applies standard Markdown formatting (bold, italic, headers, lists).
• Converts toggles using > syntax.
• Formats blockquotes using " syntax.
• Creates code blocks with language labels.
• Annotates manual steps required in Notion using [NOTION: ...] tags.
• Handles tables using pipe syntax.

Example prompts

• "Format this text I just generated for Notion."
• "Convert this .md file into a format suitable for importing into Notion."
• “Apply language-labeled code blocks and pipe-syntax tables to this content.”

Tips & gotchas

• Always verify the output in Notion after pasting, paying attention to line breaks and language detection.
• For complex tables, consider creating them manually within Notion directly.
• Ensure image URLs are accessible online before importing into Notion.