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.