Notion2docx

Notion to DOCX Conversion Guide

Prerequisites & Compatibility

[!Important] Environment Check (AI Diagnostic Reference): This skill relies on a local Python environment and Windows-specific software. Before execution, ensure:

1. Microsoft Word: Must be installed on Windows (used for rendering).
2. Pandoc: Must be installed and added to the system PATH (used for formula conversion).
3. Python & uv: Requires uv package manager for dependency handling.
4. NOTION_API_KEY: Must be set in system environment variables with page access.

Step 1: Obtain the Notion Page/Repository ID

• If the user did not provide an ID (32-bit string): Search for the ID using the uv command:

cd scripts
uv run --with-requirements requirements.txt python -B -c "from components.notion_api import search_notion_targets; targets = search_notion_targets(); print([(v['id'], v['title']) for v in targets.values()])"

Find the ID matching the title provided by the user from the output.

Step 2: Perform the Transformation

Automatically process dependencies and execute the main script using the uv command. The script will automatically fetch the Notion page title and use it as the filename.

uv run --with-requirements requirements.txt python -B main.py <page_id> -o "<output_directory>"

[!Prompt]

Output path rules:

If not provided, be sure to ask the user for the exact output path (e.g., "C:\Users<username>\Documents\output_notion_to_docx").

Example:

cd scripts
uv run --with-requirements requirements.txt python -B main.py 31ea7038c2628087b1dbf4611ea85018 -o "C:/Users/ken.liu/Documents/output_notion_to_docx"

This script will automatically perform the following operations:

1. Search for the Notion title to use as the output filename.
2. Retrieve Notion content and generate HTML.
3. Convert HTML to DOCX via Microsoft Word COM.
4. Inject natively editable mathematical formulas (MathML → OMML).

Step 3: Report Output

• Success 🎉: Inform the user of the final file path:

<output directory>/<clean_id>/<notion_title>.docx

• Failure ❌: Report any errors (e.g., 404 Not Found or missing API key).

Quick Reference