note-export-import

Convert note.com WXR exports to Markdown drafts and generate import-ready WXR.

1|Updated Aug 2, 2025
One-click install
npx skills add https://github.com/s977043/my-blog --skill note-export-import
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: note-export-import
Source: https://github.com/s977043/my-blog/tree/main/.claude/skills/note-export-import
Command: npx skills add https://github.com/s977043/my-blog --skill note-export-import

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markdown, markdownify, and includes scripts (resource) components.

What problem does it solve?

note-export-import provides end-to-end management for note.com exports (WXR) and the generation of import-ready WXR, reorganizing articles_note/ for reliable offline editing and re-import workflows.

Core Features & Use Cases

  • Ingest official note exports (WXR/XML) and reconstitute local drafts and assets.
  • Generate import-ready WXR from Markdown drafts for seamless note import.
  • Validate and coordinate workflows across scripts md_to_wxr.py, wxr_to_md.py, and verify_wxr.py to ensure compatibility with the official export format.

Quick Start

Run the note-export-import workflow to convert a note export into local drafts and WXR for import.

Frequently Asked Questions about note-export-import

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert note.com exports to local Markdown drafts?

To convert note.com exports to local Markdown drafts, you ingest official WXR or XML files. The workflow reconstitutes articles and assets into an organized directory structure for reliable offline editing.

What is the best way to generate WXR files from Markdown for note.com import?

Generating import-ready WXR from Markdown drafts is handled by the md_to_wxr workflow. It applies status tagging and asset handling to ensure the final output matches the official note.com import schema.

Does this workflow validate WXR compatibility against the official note.com export format?

Yes, the workflow validates WXR compatibility against the official export format. It uses a dedicated verify_wxr script to check structural compliance and prevent import failures before synchronization.

Can I use Markdown to synchronize and re-import content across different note environments?

Yes, you can synchronize content across environments by converting Markdown drafts into import-ready WXR. This enables seamless re-importing of archived and edited notes back into note.com.

Why does my note.com WXR import fail after editing the XML export?

WXR import failures often occur when edited XML no longer matches the official export schema. Running the workflow's validation script verifies compatibility and flags structural issues before you attempt re-import.