md-to-scrapbox

Convert Markdown documents into Scrapbox formatted .txt files.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/kentoku24/project-guild --skill md-to-scrapbox
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: md-to-scrapbox
Source: https://github.com/kentoku24/project-guild/tree/main/docs/skills/md-to-scrapbox
Command: npx skills add https://github.com/kentoku24/project-guild --skill md-to-scrapbox

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

MarkdownファイルをScrapbox(Cosense)形式に変換し、同名の.txtファイルを同ディレクトリに出力します。

Core Features & Use Cases

  • 見出し階層を Scrapbox の形式に変換します(例: # 見出し → [**** 見出し] など)。
  • コードブロックを Scrapbox 用の code セクションへ適切にインデントして変換します。
  • マーメイド図を Scrapbox 記法に準拠して埋め込み用に変換します。
  • テーブルを Scrapbox テーブル記法へ変換し、出力ファイルへ反映します。
  • 文章の装飾やリンクは Scrapbox 形式へマッピングします。

Quick Start

Markdownファイルを指定して実行すると、同名の.txtが同じディレクトリに生成されます。

Frequently Asked Questions about md-to-scrapbox

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

FAQPage Schema
How do I convert Markdown to Scrapbox format?▼

The tool processes Markdown files and outputs a Scrapbox-formatted .txt file in the same directory. It transforms headings, code blocks, Mermaid diagrams, and tables into native Scrapbox notation in a single pass.

Does the Markdown conversion support Mermaid diagrams and tables for Cosense?▼

Yes, the Markdown conversion supports Mermaid diagrams and tables for Cosense. It transforms Mermaid diagrams into Scrapbox-compliant embedded notation and maps standard tables into Scrapbox table notation.

How do I migrate a single Markdown file to Scrapbox?▼

To migrate a single Markdown file to Scrapbox, specify the file path for processing. The system applies frontmatter-driven activation rules and outputs a converted .txt file with the identical basename in the same directory.

How are Markdown heading hierarchies mapped to Scrapbox notes?▼

Markdown heading hierarchies are mapped to Scrapbox notes by converting standard syntax like `# Heading` into Scrapbox bracketed notation. This preserves the document's structural levels during the markup transformation.