markdown-to-epub-converter

Markdown から EPUB への変換スキル

このスキルは、Markdown ドキュメントをプロフェッショナルな EPUB 電子書籍ファイルに変換します。調査ドキュメント、ブログ記事、記事、チャットの会話の要約を、デバイスを問わず使える電子書籍形式に変換するのに最適です。

概要

このスキルは複数の形式の Markdown コンテンツを受け取り、主要なすべての電子書籍リーダーで動作する、適切にフォーマットされた EPUB3 ファイルを生成します。対応するリーダーは次のとおりです。

• Apple Books
• Amazon Kindle（Mac／Windows／iOS／Android 用 Kindle 経由）
• Google Play Books
• Kobo およびその他の EPUB リーダー
• 標準的な EPUB リーダー全般

入力形式

オプション 1：Markdown テキストを直接入力

メッセージ内に Markdown コンテンツを直接入力します。

Convert this markdown to EPUB:
# My Book Title
## Chapter 1
This is chapter one content...

オプション 2：ファイルパス

変換する Markdown ファイルのパスを指定します。

動作の仕組み

1. Markdown の解析：Markdown を解析し、次のように自動処理します。

   • H1 見出し（#）を章の区切りとして扱います
   • H2 見出し（##）を章内のセクション見出しとして扱います
   • 書式（太字、斜体、リンク、リスト、コードブロック）を保持します

2. 構造の生成：適切な EPUB 構造を作成します。

   • 章から目次を自動生成
   • ナビゲーションドキュメント（EPUB3 標準）
   • メタデータ（タイトル、言語など）

3. ファイルの作成：ダウンロードして使用できる、有効な EPUB3 ファイルを生成します

使用例

例 1：ブログ記事を変換する

「次の Markdown 形式のブログ記事を EPUB に変換してください。

シンプルな Web サーバーの構築方法

はじめに

…コンテンツ…」

例 2：調査の要約を変換する

「Markdown 形式の調査メモがあります。EPUB 電子書籍に変換してください。内容は次のとおりです。

調査プロジェクト：機械学習の基礎

第 1 章：基本事項

…」

例 3：チャットの要約を変換する

「これまでの会話を Markdown 形式で要約し、参照用に EPUB に変換してください」

出力

このスキルは、次の内容を含むダウンロード可能な EPUB ファイルを生成します。

• プロフェッショナルな書式
• 目次の自動生成
• 適切な章構成
• Markdown の書式要素に対応：
  • 見出し（すべてのレベル）
  • 太字と斜体のテキスト
  • ハイパーリンク
  • リスト（番号付きと番号なし）
  • コードブロックとインラインコード
  • 引用
  • 水平線

対応する Markdown 要素

要素	Markdown	対応状況	備考
見出し	# H1 から ###### H6	完全対応	目次を自動生成
太字	**text** または __text__	完全対応
斜体	*text* または _text_	完全対応
リンク	[text](url)	完全対応	電子書籍内でクリック可能
リスト	- item または 1. item	完全対応	入れ子のリストに対応
コードブロック	```language	機能強化	シンタックスハイライトに対応できる形式、等幅フォント
インラインコード	code	機能強化	背景と枠線を適用
表	Markdown の表	機能強化	見出し行のスタイル設定、交互の行色
引用	> quote	完全対応	左側の枠線付きで表示
水平線	--- または ***	完全対応

高度な機能

強化されたコードブロック対応

コードブロックは、次のような美しい書式で表示されます。

• 高品質な等幅フォント：SF Mono、Monaco、Fira Code、Consolas など
• スタイル付き背景：青いアクセントの枠線を備えた控えめなグレーの背景
• 言語の検出：将来的なシンタックスハイライトに備え、``` の後に言語を指定できます
• 適切なエスケープ処理：HTML 文字を安全にエスケープします
• オーバーフロー処理：長い行は横スクロールで表示します

例：

def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

強化された表への対応

表は、プロフェッショナルなスタイルで表示されます。

• スタイル付き見出し：青い背景に白い文字
• 交互の行色：読みやすさを高めるゼブラ模様
• セルのパディング：読みやすい適度な間隔
• インライン書式：セル内でコード、太字、斜体、リンクを使用できます
• レスポンシブ対応：表はさまざまな画面サイズに合わせて調整されます

例：

機能	状態	備考
見出し	✓	完全対応
コード	✓	書式を強化
表	✓	プロフェッショナルなレイアウト

カスタムタイトルとメタデータ

EPUB のメタデータを指定できます。

• 書籍タイトル（デフォルトは最初の H1 ヘッダー）
• 著者名
• 言語
• 出版日

章の構成

章は次の要素から自動的に検出されます。

• H1 ヘッダー（#）を章の主要な区切りとして使用
• H1 の間にある論理的なコンテンツセクション
• 章の間に自動で挿入される改ページ

スタイル

生成される EPUB には、次の特長を備えた、すっきりと読みやすいデフォルトのスタイルが適用されます。

• 読者のフォント設定を尊重する
• すべての画面サイズに対応する
• 適切な間隔と階層を維持する
• 適切なマージンとパディングを含む

技術的な詳細

• 形式：EPUB3（最新のすべてのリーダーと互換性があります）
• エンコーディング：UTF-8
• HTML バージョン：XHTML 1.1
• CSS サポート：レスポンシブスタイル

EPUB のダウンロード

生成後、ファイルをダウンロードできるようになります。その後、次の操作を行えます。

1. EPUB をコンピューターにダウンロードする
2. お好みの電子書籍リーダーで開く
3. Kindle、iPad、またはその他のデバイスに転送する
4. メールまたはクラウド経由で Kindle に直接アップロードする

最適な結果を得るためのヒント

1. 適切な Markdown 構造を使用する：Markdown が標準的な規則（タイトルには H1、セクションには H2）に従っている場合、このスキルは最適に動作します

2. 章の区切りを明確にする：H1 ヘッダーを使用して章の区切りを明確に示します

3. わかりやすいヘッダーを付ける：ヘッダーは目次になるため、明確で内容が伝わるものにします

4. コンテンツを整理する：ヘッダーの間にコンテンツを論理的に配置します

5. サポートされている書式を使用する：すべてのリーダーで高い互換性を得るには、基本的な Markdown の書式を使用します

トラブルシューティング

EPUB が開かない：Markdown が正しく書式設定されていることを確認してください。リンクの角括弧が対応していることと、構文が正しいことを確認します。

目次が空である：章を定義する H1 ヘッダーが Markdown に含まれていることを確認してください。

書式が異なって見える：EPUB リーダーは独自のフォントとスタイルを適用します。これは正常であり、想定された動作です。

スクリプト

• epub_generator.py - EPUB ファイルの作成と書式設定を行うコアスクリプト
• markdown_processor.py - Markdown の解析と構造の抽出を行うスクリプト

今後の機能強化

• カスタム画像を使った表紙の自動生成
• Kindle 向けの最適化（.mobi 形式）
• ユーザー設定に応じたカスタム CSS スタイル
• 複数ドキュメントの結合
• 画像の埋め込みと最適化
• 高度なメタデータのサポート