Overview
The Notion MD node is designed to transform content between Markdown and Notion block formats. It currently supports converting Markdown input into Notion blocks, making it useful for workflows where you need to import or process Markdown content in a format compatible with Notion's API or data structures.
Common scenarios:
- Automating the migration of Markdown documents into Notion databases.
- Integrating external Markdown sources (e.g., documentation, notes) into Notion via n8n workflows.
- Preprocessing Markdown before sending it to other tools that expect Notion block format.
Practical example:
You have a collection of Markdown files and want to batch-import them as structured Notion pages using n8n automation.
Properties
Name | Meaning |
---|---|
Input | The input to be transformed. Place your markdown or notion blocks here. |
Output Key | Key to use for the output object. Determines under which property name the result will be stored in JSON. |
Output
- The node outputs an object where the key is defined by the Output Key property (default:
output
). - The value is an array of Notion block objects resulting from the Markdown-to-Notion conversion.
Example output:
{
"output": [
{
"object": "block",
"type": "paragraph",
"paragraph": {
"text": [
{
"type": "text",
"text": { "content": "Sample text" }
}
]
}
}
// ...more blocks
]
}
Note: The actual structure follows Notion's block object schema.
Dependencies
- External library: Uses
@tryfabric/martian
for Markdown-to-Notion conversion. - No API keys or special n8n configuration required for this transformation.
Troubleshooting
- Operation not implemented: If you select "Notion to Markdown", the node will throw an error:
"not implemeted"
Resolution: Only "Markdown to Notion" is supported at this time. - Unknown operation: If an invalid operation is provided, you'll see:
The operation "<operation>" is not known!
Resolution: Ensure the "Operation" property is set to a valid option. - Input errors: If the input is not valid Markdown, the output may be empty or malformed.
Resolution: Check your input for correct Markdown syntax.