Markdown から専門的な PDF 書籍へのコンバーター

Markdown 形式の技術書籍/チュートリアルを専門的に排版された PDF 電子書籍に変換します。

使用する場合

• ユーザーが Markdown ファイルパスを提供し、PDF への変換をリクエストした場合
• ユーザーが「PDF をエクスポート」「電子書籍を生成」「PDF を作成」と言及した場合
• ユーザーが書籍レベルの排版出力が必要な場合

クイックコマンド

node scripts/md2book.js <input.md>
node scripts/md2book.js <input.md> --theme <minimal|academic|playful>
node scripts/md2book.js <input.md> --output <path.pdf>
node scripts/md2book.js <input.md> --verbose

完全なワークフロー

Phase 1: 入力の確認

1. ユーザーが Markdown ファイルパスを提供したことを確認する
2. ファイルが存在するかチェックする
3. ファイルが YAML frontmatter（title、author、date など）を持っているかチェックする
4. frontmatter がない場合、ユーザーに重要情報（書名、著者）の追加を質問する

Phase 2: パラメータの確認

ユーザーに以下を確認します：

• テーマスタイル（デフォルト minimal）：
  • minimal — ミニマルテック風（大量の余白、黒白グレー、技術書に最適）
  • academic — クラシックアカデミック風（セリフ体、暖色用紙、落ち着いた専門的デザイン）
  • playful — 活発なイラスト風（豊富な色彩、グラデーション装飾）
• 出力パス（デフォルト MD ファイルと同じディレクトリ）
• 目次が必要かどうか（デフォルト生成）

Phase 3: 変換の実行

cd /Users/bytedance/Documents/CC/huashu/huashu-bookwriter-skill
node scripts/md2book.js <input.md> --theme <theme> --verbose

Phase 4: 出力の検証

1. PDF ファイルが生成されたかチェックする
2. 以下の項目を検証します：
   • 表紙が正常にレンダリングされている（書名、著者が見える）
   • 著作権ページに完全な情報が含まれている
   • 目次が正しく生成されている
   • 各 # チャプターが新しいページから始まっている
   • 中文に文字化けがない
   • ページ番号が連続している
   • コードブロック/表がカットされていない
3. 問題がある場合は、エラーログを確認して修正する

入力ファイル形式

Markdown ファイルは YAML frontmatter を含める必要があります：

---
title: 書名
subtitle: サブタイトル（オプション）
author: 著者名
publisher: 出版社（オプション）
version: v1.0
date: 2026-04-10
isbn: 978-0-000000-00-0（オプション）
description: ワンライナー概要
---

# 第1章 はじめに

本文内容...

## 1.1 概要

その他の内容...

サポートされている Markdown 機能

• 標準 GFM（表、コードブロック、リスト）
• コード構文強調表示（highlight.js）
• Callout 通知ボックス：[!INFO]、[!TIP]、[!WARNING]、[!DANGER]
• 画像と画像キャプション
• ブロック引用
• 自動目次生成

ビジュアルテーマの説明

minimal（ミニマルテック風）

• 純白背景、黒白グレー配色
• Source Han Serif 本文 + 黒体タイトル
• シンプルな装飾ライン
• 適用：技術ドキュメント、プログラミングチュートリアル

academic（クラシックアカデミック風）

• 暖色用紙テクスチャ背景
• 深紅色アクセントカラー
• クラシックセリフ体フォント
• 適用：理論的著作、学術専著

playful（活発なイラスト風）

• グラデーション彩色表紙
• 角丸カードデザイン
• 豊富な色彩変化
• 適用：入門チュートリアル、科学啓蒙書籍

トラブルシューティング

中文がボックスで表示される

• システムに Source Han Serif または宋体がインストールされているか確認する
• macOS は Songti SC と STSong が組み込まれています
• references/font-guide.md でフォント設定を確認できます

Playwright ブラウザがインストールされていない

cd /Users/bytedance/Documents/CC/huashu/huashu-bookwriter-skill/scripts
npx playwright install chromium

依存関係がインストールされていない

cd /Users/bytedance/Documents/CC/huashu/huashu-bookwriter-skill/scripts
npm install

PDF コンテンツが空白

• Markdown ファイルのエンコーディングが UTF-8 であるか確認する
• --verbose を使用して変換ログを表示する
• frontmatter フォーマットが正しいか確認する

Chromium ブラウザが見つからない

• スクリプトは ~/Library/Caches/ms-playwright/ 下の Chromium を自動検出します
• インストールされていない場合は npx playwright install chromium を実行します
• インストール後、変換コマンドを再実行します

関連ファイル

• scripts/md2book.js — メイン変換スクリプト
• scripts/package.json — 依存関係設定
• assets/styles/book.css — 書籍コアスタイル（ページング、ページヘッダー/フッター）
• assets/styles/typography.css — 中文フォント排版
• assets/styles/components.css — 表/コードブロック/引用/Callout スタイル
• assets/styles/themes/ — 3 つのビジュアルテーマ（minimal、academic、playful）
• references/font-guide.md — フォント設定リファレンス