mcpField
M
markdown-exporter

markdown-exporter

github.com/bowenliang123ドキュメント274166 回インストール11 週間前に更新
リポジトリ

markdown-exporter について

markdown-exporterは、Markdownファイルを文書、画像、データ形式に変換するエージェントスキル、CLI、Pythonパッケージです。Markdownから多様な形式を作成でき、DOCXとPPTXではテンプレートも指定できます。

主な機能

  1. 01DOCX、HTML、PDF、PPTXへの出力
  2. 02PNGまたはSVGとしてレンダリング
  3. 03表をXLSX、CSV、JSONなどに変換
  4. 04コードブロックを個別ファイルに抽出
  5. 05DOCXとPPTXのテンプレートに対応

活用シーン

  1. 01MarkdownからWordやPDFを作成
  2. 02Markdownの表を表計算やデータ形式に変換
  3. 03Markdownをページ分割画像として出力
  4. 04文書からコードブロックを抽出

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bowenliang123/markdown-exporter --skill markdown-exporter

インストール後、Claude Code で/markdown-exporterを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.difyignore
AGENTS.md
.env.example
.gitignore
.ruff.toml
README.md
MANIFEST.in
LICENSE.txt
PRIVACY.md
main.py
manifest.yaml
.claude-plugin/
marketplace.json
plugin.json
.github/
PULL_REQUEST_TEMPLATE.md
.github/workflows/
plugin-publish.yml
python-publish.yml
dev/
bump-version.sh
pack-clawhub.sh
pack-dify-plugin.sh
uv-sync-with-dify.sh
reformat.sh
test.sh
uv-sync.sh
md_exporter/
__init__.py
cli.py
md_exporter/assets/fonts/
LICENSE
md_exporter/parser/
cli_md_to_codeblock.py
cli_md_to_html.py
cli_md_to_docx.py
cli_md_to_csv.py

詳細

Markdown Exporter

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

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

ツールと対応形式
ツール入力（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 枚の画像
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 パッケージとして提供され、すべての機能をシームレスに利用できるコマンドラインインターフェースを備えています。

インストール
# with pip
pip install md-exporter

# with uv 
uv tool install md-exporter

# on 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 入力の例： 下記の「基本的なテキストとテーブル」セクションにある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 入力の例： 下の「Markdown 入力例 - 基本的なテキストと表」セクションにある「基本的なテキストと表」の例を使用してください。

md_to_png - Markdown を PNG に変換

Markdown テキストを、中国語、日本語などの言語に対応した PNG 画像に変換します。

使用方法：

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

引数：

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

オプション：

  • --multi-page - 1 枚の縦長 PNG ではなく、A4 ページごとに PNG を 1 枚ずつ（連番ファイルとして）出力します
  • --strip-wrapper - コードブロックのラッパーがある場合は削除します

例：

  1. 基本的な変換（1 枚の縦長画像）：

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

    Markdown ドキュメント全体を 1 枚の縦長 PNG 画像として描画します。

  2. 複数ページでの出力：

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

    ドキュメントが複数ページある場合、A4 ページごとに PNG を 1 枚ずつ出力し、output_1.png、output_2.png などの名前で保存します。

  3. コードブロックのラッパーを削除して変換：

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

    Markdown の処理前にコードブロックのラッパー（```）を削除します。

Markdown 入力の例： 下の「Markdown 入力例 - 基本的なテキストと表」セクションにある「基本的なテキストと表」の例を使用してください。

md_to_svg - Markdown を SVG に変換

Markdown テキストを、中国語、日本語などの言語に対応した 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 入力の例： 下の「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 入力の例： 下の「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

    Markdown を処理する前に、コードブロックのラッパー（```）を削除します。

  3. テキストへの強制を無効化：

    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 行に JSON オブジェクト 1 つ）に変換します。

  2. JSON 配列に変換：

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

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

  3. コードブロックのラッパーを削除：

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

    Markdown を処理する前に、コードブロックのラッパー（```）を削除します。

サンプル 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 入力： 以下の「サンプル Markdown 入力 - 基本的なテキストとテーブル」セクションにある「基本的なテキストとテーブル」の例を使用してください。

md_to_latex - Markdown の表を LaTeX に変換

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

使用方法：

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

引数：

  • input - 表を含む入力 Markdown ファイルのパス
  • output - 出力 LaTeX ファイルのパス

オプション：

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

例：

  1. 基本的な変換：

    markdown-exporter md_to_latex /path/input.md /path/output.tex

    入力 Markdown ファイル内のすべての表を LaTeX 形式に変換します。

  2. コードブロックのラッパーを削除する場合：

    markdown-exporter md_to_latex /path/input.md /path/output.tex --strip-wrapper

    Markdown を処理する前に、コードブロックのラッパー（```）をすべて削除します。

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

md_to_html - Markdown を HTML に変換

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

使用方法：

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

引数：

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

オプション：

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

例：

  1. 基本的な変換：

    markdown-exporter md_to_html /path/input.md /path/output.html

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

  2. コードブロックのラッパーを削除する場合：

    markdown-exporter md_to_html /path/input.md /path/output.html --strip-wrapper

    Markdown を処理する前に、コードブロックのラッパー（```）をすべて削除します。

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

md_to_html_text - Markdown を HTML テキストに変換

Markdown テキストを HTML に変換し、標準出力に出力します。

使用方法：

markdown-exporter md_to_html_text <input>

引数：

  • input - 入力 Markdown ファイルのパス

例：

markdown-exporter md_to_html_text /path/input.md

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

md_to_jira - Markdown を Jira Wiki マークアップに変換

Markdown テキストを Jira Wiki マークアップに変換し、標準出力に出力します。

使用方法：

markdown-exporter md_to_jira <input>

引数：

  • input - 入力 Markdown ファイルのパス

例：

markdown-exporter md_to_jira /path/input.md

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

md_to_md - Markdown を MD ファイルに変換

Markdown テキストを .md ファイルに保存します。

使用方法：

markdown-exporter md_to_md <input> <output>

引数：

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

例：

markdown-exporter md_to_md /path/input.md /path/output.md

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

md_to_ipynb - Markdown を IPYNB に変換

Markdown テキストを Jupyter Notebook（.ipynb）形式のファイルに変換します。

使用方法：

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

引数：

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

オプション：

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

例：

  1. 基本的な変換：

    markdown-exporter md_to_ipynb /path/input.md /path/output.ipynb

    Markdown ファイルを Jupyter Notebook 形式に変換します。

  2. コードブロックのラッパーを削除する場合：

    markdown-exporter md_to_ipynb /path/input.md /path/output.ipynb --strip-wrapper

    Markdown を処理する前に、コードブロックのラッパー（```）をすべて削除します。

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

サンプル Markdown 入力

各種ツールのテストに役立つよう、入力ファイルの内容を表す一般的な Markdown 入力例を以下に示します。

基本テキストと表
# Test Markdown File

This is a test markdown file for testing various export tools.

## Table Test

| Name | Description | Price |
|------|-------------|-------|
| Item 1 | First item | $10 |
| Item 2 | Second item | $20 |
| Item 3 | Third item | $30 |

## Text Test

This is a paragraph with **bold** and *italic* text.

- List item 1
- List item 2
- List item 3

> This is a blockquote.
コードブロック
# Test Markdown File

## Code Block Test

```python
print("Hello, World!")
def add(a, b):
    return a + b

# Test the function
result = add(5, 3)
print(f"Result: {result}")
```

```bash
# Bash script example
echo "Hello from Bash"
ls -la
```

```javascript
// JavaScript example
console.log("Hello from JavaScript");
function multiply(a, b) {
    return a * b;
}
```
スライド（PPTX 用）
---
title: Markdown Exporter
author: Bowen Liang
---

# Introduction

## Welcome Slide

Welcome to our Markdown Exporter!

::: notes
Remember to greet the audience warmly.
:::

---

# Section 1: Basic Layouts

## Title and Content

- This is a basic slide with bullet points
- It uses the "Title and Content" layout
- Perfect for simple content presentation

## Two Column Layout

::::: columns
::: column
Left column content:
- Point 1
- Point 2
:::
::: column
Right column content:
- Point A
- Point B
:::
:::::

## Comparison Layout

::::: columns
::: column
Text followed by an image:

![Test Image](https://example.com/image.jpg)
:::
::: column
- This triggers the "Comparison" layout
- Useful for side-by-side comparisons
:::
:::::

## Content with Caption

Here's some explanatory text about the image below.

![Test Image](https://example.com/image.jpg "fig:Test Image")

---

# Section 2: Advanced Features

## Code Block

Here's a Python code block:

```python
def greet(name):
    return f"Hello, {name}!"

print(greet("World"))
```

## Table Example

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Row 1    | Data     | More     |
| Row 2    | Info     | Stuff    |

## Incremental List

::: incremental
- This point appears first
- Then this one
- And finally this one
:::

## {background-image="https://example.com/image.jpg"}

::: notes
This is a slide with a background image and speaker notes only.
The "Blank" layout will be used.
:::

# Conclusion

## Thank You

Thank you for viewing this kitchen sink presentation!

::: notes
Remember to thank the audience and invite questions.
:::

📝 注意事項

  • すべてのスクリプトは、入力としてファイルパスのみをサポートします
  • 複数のファイルを生成するスクリプト（複数の表やコードブロックなど）では、出力ファイル名に自動で連番が付けられます
  • --strip-wrapper オプションを使用すると、入力 Markdown からコードブロックのラッパー（```）を削除できます

コメント

Markdown 対応