bowenliang123/markdown-exporter

Markdown Exporter

Markdown Exporterは、Markdownテキストをさまざまなプロフェッショナル形式のファイルに変換するAgentスキルです。

このAgentスキル用のSKILL.md、CLIツール、およびPythonパッケージ markdown-exporterは、GitHubリポジトリbowenliang123/markdown-exporterでbowenliang123によって管理されています。

ツールと対応形式

ツール	入力（Markdownテキストまたはスタイルのファイルパス）	出力（エクスポートされたファイルのファイルパス）
md_to_docx	📝 Markdownテキスト	📄 Word文書 (.docx)
md_to_html	📝 Markdownテキスト	🌐 HTMLファイル (.html)
md_to_html_text	📝 Markdownテキスト	🌐 HTMLテキスト文字列
md_to_jira	📝 Markdownテキスト	🅹 Jira Wikiマークアップテキスト
md_to_pdf	📝 Markdownテキスト	📑 PDFファイル (.pdf)
md_to_png	📝 Markdownテキスト	🖼️ PNG画像 (.png)、単一長ページまたは1ページあたり1画像
md_to_svg	📝 Markdownテキスト	🖼️ SVG画像 (.svg)、1ページあたり1画像
md_to_md	📝 Markdownテキスト	📝 Markdownファイル (.md)
md_to_ipynb	📝 Markdownテキスト	📓 Jupyter Notebook (.ipynb)
md_to_pptx	📝 PandocスタイルのMarkdownスライド	🎯 PowerPoint (.pptx)
md_to_xlsx	📋 Markdownテーブル	📊 Excelスプレッドシート (.xlsx)
md_to_csv	📋 Markdownテーブル	📋 CSVファイル (.csv)
md_to_json	📋 Markdownテーブル	📦 JSON/JSONLファイル (.json)
md_to_xml	📋 Markdownテーブル	🏷️ XMLファイル (.xml)
md_to_latex	📋 Markdownテーブル	📝 LaTeXファイル (.tex)
md_to_codeblock	💻 Markdown内のコードブロック	📁 言語別のコードファイル (.py, .js, .sh など)

📦 使用方法

概要

Markdown ExporterはPyPIパッケージとして利用でき、すべての機能に対応したシームレスなコマンドラインインターフェースを提供します。

インストール

# pipを使用
pip install md-exporter

# uvを使用
uv tool install md-exporter

# OpenClaw上
npx clawhub install markdown-exporter

markdown-exporterコマンドと使用方法を確認:

markdown-exporter -h

markdown-exporter <subcommand> -h

基本的な使い方

すべてのツールにアクセスするには、markdown-exporterコマンドを使用します:

markdown-exporter <subcommand> <args> [options]

重要な注意点

• すべてのコマンドは入力としてファイルパスのみをサポートします
• パッケージはすべての依存関係を自動的に管理します
• システム上のどこからでもコマンドを実行できます。プロジェクトディレクトリに移動する必要はありません

🔧 スクリプト

md_to_csv - MarkdownテーブルをCSVに変換

MarkdownテーブルをCSV形式のファイルに変換します。

使用方法:

markdown-exporter md_to_csv <input> <output> [options]

引数:

• input - テーブルを含む入力Markdownファイルパス
• output - 出力CSVファイルパス

オプション:

• --strip-wrapper - 存在する場合、コードブロックラッパーを削除します

例:

1. 基本変換:

   markdown-exporter md_to_csv /path/input.md /path/output.csv
   

   入力Markdownファイル内のすべてのテーブルをCSV形式に変換します。

2. コードブロックラッパー削除あり:

   markdown-exporter md_to_csv /path/input.md /path/output.csv --strip-wrapper
   

   マークダウンを処理する前にコードブロックラッパー（```）を削除します。

サンプルMarkdown入力: 以下の「サンプルMarkdown入力 - 基本テキストとテーブル」セクションの「基本テキストとテーブル」の例を使用してください。

---

md_to_pdf - MarkdownをPDFに変換

MarkdownテキストをPDF形式に変換します。中国語、日本語、その他の言語に対応しています。

使用方法:

markdown-exporter md_to_pdf <input> <output> [options]

引数:

• input - 入力Markdownファイルパス
• output - 出力PDFファイルパス

オプション:

• --strip-wrapper - 存在する場合、コードブロックラッパーを削除します

例:

1. 基本変換:

   markdown-exporter md_to_pdf /path/input.md /path/output.pdf
   

   Markdownファイル全体をPDFドキュメントに変換します。

2. コードブロックラッパー削除あり:

   markdown-exporter md_to_pdf /path/input.md /path/output.pdf --strip-wrapper
   

   マークダウンを処理する前にコードブロックラッパー（```）を削除します。

サンプルMarkdown入力: 以下の「サンプルMarkdown入力 - 基本テキストとテーブル」セクションの「基本テキストとテーブル」の例を使用してください。

---

md_to_png - MarkdownをPNGに変換

MarkdownテキストをPNG画像に変換します。中国語、日本語、その他の言語に対応しています。

使用方法:

markdown-exporter md_to_png <input> <output> [options]

引数:

• input - 入力Markdownファイルパス
• output - 出力PNGファイルパス

オプション:

• --multi-page - 単一の長ページPNGの代わりに、A4ページごとに1つのPNG（番号付きファイル）をエクスポートします
• --strip-wrapper - 存在する場合、コードブロックラッパーを削除します

例:

1. 基本変換（単一長ページ画像）:

   markdown-exporter md_to_png /path/input.md /path/output.png
   

   Markdownドキュメント全体を単一の長ページPNG画像としてレンダリングします。

2. マルチページ出力:

   markdown-exporter md_to_png /path/input.md /path/output.png --multi-page
   

   ドキュメントが複数ページある場合、A4ページごとに1つのPNGをエクスポートし、output_1.png、output_2.pngなどとして保存します。

3. コードブロックラッパー削除あり:

   markdown-exporter md_to_png /path/input.md /path/output.png --strip-wrapper
   

   マークダウンを処理する前にコードブロックラッパー（```）を削除します。

サンプルMarkdown入力: 以下の「サンプルMarkdown入力 - 基本テキストとテーブル」セクションの「基本テキストとテーブル」の例を使用してください。

---

md_to_svg - MarkdownをSVGに変換

MarkdownテキストをSVG画像に変換します。1ページにつき1つのSVGで、中国語、日本語、その他の言語に対応しています。

使用方法:

markdown-exporter md_to_svg <input> <output> [options]

引数:

• input - 入力Markdownファイルパス
• output - 出力SVGファイルパス

オプション:

• --strip-wrapper - 存在する場合、コードブロックラッパーを削除します

例:

1. 基本変換:

   markdown-exporter md_to_svg /path/input.md /path/output.svg
   

   MarkdownファイルをSVG画像に変換します。ドキュメントが複数ページある場合、output_1.svg、output_2.svgなどとして保存されます。

2. コードブロックラッパー削除あり:

   markdown-exporter md_to_svg /path/input.md /path/output.svg --strip-wrapper
   

   マークダウンを処理する前にコードブロックラッパー（```）を削除します。

サンプルMarkdown入力: 以下の「サンプルMarkdown入力 - 基本テキストとテーブル」セクションの「基本テキストとテーブル」の例を使用してください。

---

md_to_docx - MarkdownをDOCXに変換

MarkdownテキストをDOCX形式のファイルに変換します。

使用方法:

markdown-exporter md_to_docx <input> <output> [options]

引数:

• input - 入力Markdownファイルパス
• output - 出力DOCXファイルパス

オプション:

• --template - DOCXテンプレートファイルへのパス（オプション）
• --strip-wrapper - 存在する場合、コードブロックラッパーを削除します

例:

1. 基本変換:

   markdown-exporter md_to_docx /path/input.md /path/output.docx
   

   Markdownファイル全体をDOCXドキュメントに変換します。

2. カスタムテンプレートあり:

   markdown-exporter md_to_docx /path/input.md /path/output.docx --template /path/template.docx
   

   カスタムDOCXテンプレートをスタイルに使用します。

3. コードブロックラッパー削除あり:

   markdown-exporter md_to_docx /path/input.md /path/output.docx --strip-wrapper
   

   マークダウンを処理する前にコードブロックラッパー（```）を削除します。

サンプルMarkdown入力: 以下の「サンプルMarkdown入力 - 基本テキストとテーブル」セクションの「基本テキストとテーブル」の例を使用してください。

---

md_to_xlsx - MarkdownテーブルをXLSXに変換

Markdownテーブルを複数シート対応のXLSX形式に変換します。

使用方法:

markdown-exporter md_to_xlsx <input> <output> [options]

引数:

• input - テーブルを含む入力Markdownファイルパス
• output - 出力XLSXファイルパス

オプション:

• --force-text - セル値をテキスト型に変換します（デフォルト: True）
• --strip-wrapper - 存在する場合、コードブロックラッパーを削除します

例:

1. 基本変換:

   markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx
   

   入力Markdownファイル内のすべてのテーブルをXLSXワークブックに変換し、各テーブルを個別のシートに配置します。

2. コードブロックラッパー削除あり:

   markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx --strip-wrapper
   

   マークダウンを処理する前にコードブロックラッパー（```）を削除します。

3. force-text無効時:

   markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx --force-text False
   

   Excelがセルタイプを自動的に決定できるようにします。

サンプルMarkdown入力: 以下の「サンプルMarkdown入力 - 基本テキストとテーブル」セクションの「基本テキストとテーブル」の例を使用してください。

---

md_to_pptx - MarkdownをPPTXに変換

MarkdownテキストをPPTX形式のファイルに変換します。

使用方法:

markdown-exporter md_to_pptx <input> <output> [options]

引数:

• input - 入力Markdownファイルパス
• output - 出力PPTXファイルパス

オプション:

• --template - PPTXテンプレートファイルへのパス（オプション）

例:

1. 基本変換:

   markdown-exporter md_to_pptx /path/input.md /path/output.pptx
   

   MarkdownファイルをPowerPointプレゼンテーションに変換します。

2. カスタムテンプレートあり:

   markdown-exporter md_to_pptx /path/input.md /path/output.pptx --template /path/template.pptx
   

   カスタムPowerPointテンプレートをスタイルに使用します。

サンプルMarkdown入力: 以下の「サンプルMarkdown入力 - スライド（PPTX用）」セクションの「スライド（PPTX用）」の例を使用してください。

---

md_to_codeblock - コードブロックをファイルに抽出

Markdownからコードブロックを抽出し、個別のファイルとして保存します。

使用方法:

markdown-exporter md_to_codeblock <input> <output> [options]

引数:

• input - コードブロックを含む入力Markdownファイルパス
• output - 出力ディレクトリパスまたはZIPファイルパス

オプション:

• --compress - すべてのコードブロックをZIPファイルに圧縮します

例:

1. ディレクトリに抽出:

   markdown-exporter md_to_codeblock /path/input.md /path/output_dir
   

   すべてのコードブロックを指定されたディレクトリ内の個別ファイルに抽出します。

2. ZIPファイルに抽出:

   markdown-exporter md_to_codeblock /path/input.md /path/output.zip --compress
   

   すべてのコードブロックを抽出し、ZIPファイルに圧縮します。

サンプルMarkdown入力: 以下の「サンプルMarkdown入力 - コードブロック」セクションの「コードブロック」の例を使用してください。

---

md_to_json - MarkdownテーブルをJSONに変換

MarkdownテーブルをJSONまたはJSONL形式のファイルに変換します。

使用方法:

markdown-exporter md_to_json <input> <output> [options]

引数:

• input - テーブルを含む入力Markdownファイルパス
• output - 出力JSONファイルパス

オプション:

• --style - JSON出力スタイル: jsonl（デフォルト）または json_array
• --strip-wrapper - 存在する場合、コードブロックラッパーを削除します

例:

1. 基本変換（JSONL形式）:

   markdown-exporter md_to_json /path/input.md /path/output.json
   

   テーブルをJSON Lines形式（1行に1つのJSONオブジェクト）に変換します。

2. JSON配列に変換:

   markdown-exporter md_to_json /path/input.md /path/output.json --style json_array
   

   テーブルを単一のJSONオブジェクト配列に変換します。

3. コードブロックラッパー削除あり:

   markdown-exporter md_to_json /path/input.md /path/output.json --strip-wrapper
   

   マークダウンを処理する前にコードブロックラッパー（```）を削除します。

サンプルMarkdown入力: 以下の「サンプルMarkdown入力 - 基本テキストとテーブル」セクションの「基本テキストとテーブル」の例を使用してください。

---

md_to_xml - MarkdownをXMLに変換

MarkdownテキストをXML形式のファイルに変換します。

使用方法:

markdown-exporter md_to_xml <input> <output> [options]

引数:

• input - 入力Markdownファイルパス
• output - 出力XMLファイルパス

オプション:

• --strip-wrapper - 存在する場合、コードブロックラッパーを削除します

例:

1. 基本変換:

   markdown-exporter md_to_xml /path/input.md /path/output.xml
   

   Markdownファイル全体をXMLドキュメントに変換します。

2. コードブロックラッパー削除あり:

   markdown-exporter md_to_xml /path/input.md /path/output.xml --strip-wrapper
   

   マークダウンを処理する前にコードブロックラッパー（```）を削除します。

サンプルMarkdown入力: 以下の「サンプルMarkdown入力 - 基本テキストとテーブル」セクションの「基本テキストとテーブル」の例を使用してください。

---

md_to_latex - MarkdownテーブルをLaTeXに変換

MarkdownテーブルをLaTeX形式のファイルに変換します。

使用方法:

markdown-exporter md_to_latex <input> <output> [options]

引数:

• input - テーブルを含む入力Markdownファイルパス
• output - 出力LaTeXファイルパス

オプション:

• --strip-wrapper - 存在する場合、コードブロックラッパーを削除します

例:

...（翻訳のため省略）