プリセットリファレンス
md2docxには、さまざまなユースケースに最適化されたいくつかのビルトインプリセットが含まれています。このガイドでは、各プリセットに関する詳細情報を提供します。
利用可能なプリセット
config/presets/のビルトインプリセット：
minimal- シンプルなドキュメントdefault- 汎用ドキュメントtechnical- 技術ドキュメントbusiness- プロフェッショナルなビジネス文書
概要
| プリセット | ディレクトリ | 最適な用途 | テキスト方向 |
|---|---|---|---|
| minimal | config/presets/ |
シンプルなドキュメント、クイック変換 | 横書き |
| default | config/presets/ |
汎用ドキュメント | 横書き |
| technical | config/presets/ |
技術ドキュメント、APIドキュメント | 横書き |
| business | config/presets/ |
ビジネスレポート、提案書、議事録 | 横書き |
| vertical-novel | config/vertical/ |
日本語小説、縦書き | 縦書き |
標準プリセット
minimal
場所：config/presets/minimal.yaml
説明：白黒配色の最小限のスタイリング。視覚的な装飾のない直接的なMarkdownからWordへの変換に最適。
特徴：
- ページサイズ：A4（21.0 × 29.7 cm）
- フォント：Noto Serif / Noto Serif CJK JP
- 基本フォントサイズ：11pt
- 配色：白黒のみ
- 枠線：なし
- 背景：なし
スタイル詳細：
H1: 24pt、太字、黒
H2: 20pt、太字、黒
H3: 16pt、太字、黒
段落: 11pt、1.5行間
コードブロック: 10pt、ライトグレー背景（#f5f5f5）
引用: 11pt、斜体、左枠線（#999999）
使用例：
- クイック文書変換
- 印刷に適した出力
- 最小ファイルサイズ
- 学術論文（APA/MLAスタイル）
使用例：
docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
input.md -o output.docx -p minimal --preset-dir /app/config/presets
default
場所：config/presets/default.yaml
説明：ほとんどのドキュメントに適したバランスの取れたスタイリング。控えめな色と枠線を使用したプロフェッショナルな外観。
特徴：
- ページサイズ：A4（21.0 × 29.7 cm）
- フォント：Noto Serif / Noto Serif CJK JP
- 基本フォントサイズ：11pt
- 配色：ネイビーブルー（#2c3e50）とグレートーン
- 枠線：H1/H2の下枠線、引用の左枠線
- 背景：コードブロックはライトグレー、引用はライトブルー
スタイル詳細：
H1: 26pt、太字、ネイビー（#2c3e50）、ブルー下枠線（#3498db）
H2: 22pt、太字、ダークグレー（#34495e）、グレー下枠線（#95a5a6）
H3: 18pt、太字、ダークグレー（#34495e）
段落: 11pt、1.5行間、ネイビー
コードブロック: 10pt、等幅、ライトグレー背景（#ecf0f1）
引用: 11pt、斜体、グレー（#7f8c8d）、ブルー左枠線（#3498db）
使用例：
- ビジネス文書
- 提案書と報告書
- 議事録
- 一般的なドキュメント
使用例：
docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
input.md -o output.docx -p default --preset-dir /app/config/presets
technical
場所：config/presets/technical.yaml
説明：コンパクトなレイアウトとコードに適したスタイリングで技術ドキュメント用に最適化。
特徴：
- ページサイズ：A4（21.0 × 29.7 cm）
- フォント：Noto Sans / Noto Sans CJK JP（読みやすさ向上のためサンセリフ）
- 基本フォントサイズ：10pt（コンパクト）
- 配色：ダークグレー（#1a1a1a）とブルーアクセント
- 枠線：H1/H2の下枠線、コードブロックの枠線
- 背景：コードブロックと引用にライトグレー
スタイル詳細：
H1: 24pt、太字、ダーク（#1a1a1a）、ブルー下枠線（#0066cc）
H2: 20pt、太字、ダークグレー（#333333）、グレー下枠線（#4d4d4d）
H3: 16pt、太字、ダークグレー（#333333）
段落: 10pt、1.4行間、ダーク（#1a1a1a）
コードブロック: 9pt、等幅、ライトグレー背景（#f5f5f5）、枠線
引用: 10pt、グレー（#4d4d4d）、ブルー左枠線（#0066cc）
使用例：
- APIドキュメント
- ソフトウェアマニュアル
- 技術仕様書
- コード重視のドキュメント
- READMEファイル
使用例：
docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
README.md -o README.docx -p technical --preset-dir /app/config/presets
business
場所：config/presets/business.yaml
説明：広めのマージンとネイビー/ブルーのカラーパレットを使用した、フォーマルなビジネス文書向けのプロフェッショナルスタイルです。
特徴：
- ページサイズ：A4（21.0 × 29.7 cm）
- フォント：Noto Serif / Noto Serif CJK JP
- 基本フォントサイズ：11pt
- 余白：フォーマル文書向けの広めの設定（左/上/下 3.0 cm、右 2.5 cm）
- カラースキーム：ネイビー（#1a5490）とダークブルー（#2e5c8a）の見出し
- 行間：読みやすさを重視した1.75倍
スタイル詳細：
H1: 24pt、太字、ネイビー（#1a5490）、枠線なし
H2: 16pt、太字、ダークブルー（#2e5c8a）、青い下線（#4a90e2）
H3: 13pt、太字、チャコール（#34495e）
段落: 11pt、1.75倍行間、ダーク（#2c3e50）
コードブロック: 9pt、Consolas、ライトグレー背景（#f5f5f5）
引用ブロック: 11pt、青い左枠線、ライトブルー背景（#eef2f7）
ユースケース：
- ビジネス提案書
- プロジェクトレポート
- 議事録
- 社内文書
- 正式な書簡
使用例：
docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
report.md -o report.docx -p business --preset-dir /app/config/presets
比較表
視覚的特徴
| 機能 | minimal | default | technical | business |
|---|---|---|---|---|
| フォントファミリー | セリフ | セリフ | サンセリフ | セリフ |
| 基本サイズ | 10pt | 11pt | 10pt | 11pt |
| カラー | 白黒 | ネイビー/ブルー/グレー | GitHubブルー/ダーク | ネイビー/ダークブルー |
| H1枠線 | なし | 下 | 下 | なし |
| H2枠線 | なし | なし | なし | 下 |
| コードブロック | グレー背景 | ダーク背景 | GitHub灰色背景 | グレー背景 |
| 引用ブロック | 左枠線 | 左枠線 | 左枠線 | 左枠線+背景 |
レイアウト特徴
| 機能 | minimal | default | technical | business |
|---|---|---|---|---|
| ページサイズ | A4 | A4 | A4 | A4 |
| テキスト方向 | 横書き | 横書き | 横書き | 横書き |
| 余白 | 2.54 cm | 2.5 cm | 2.5 cm | 3.0 cm（広め） |
| 行間 | 1.25倍 | 1.5倍 | 1.6倍 | 1.75倍 |
ファイルサイズ（概算）
| プリセット | 一般的なファイルサイズ* |
|---|---|
| minimal | 〜12 KB |
| default | 〜14 KB |
| technical | 〜13 KB |
| business | 〜14 KB |
*標準的なMarkdownコンテンツを含む10ページのドキュメントの場合
プリセットの選択
決定木
ここから開始
│
├─ 技術ドキュメントまたはAPIドキュメント？
│ └─ はい → technical
│
├─ フォーマルなビジネス文書？
│ └─ はい → business
│
├─ 汎用ドキュメント？
│ └─ はい → default
│
└─ シンプルで最小限のスタイリング？
└─ はい → minimal
文書タイプ別
| 文書タイプ | 推奨プリセット |
|---|---|
| 技術ドキュメント | technical |
| APIリファレンス | technical |
| ソフトウェアマニュアル | technical |
| ビジネス提案書 | business |
| 議事録 | business |
| プロジェクトレポート | business |
| 汎用ドキュメント | default |
| 学術論文 | minimal |
| クイックメモ | minimal |
プリセットのカスタマイズ
すべてのプリセットは、YAMLファイルをコピーして変更することでカスタマイズできます：
1. プリセットをコピー
cp config/presets/default.yaml config/custom/my-style.yaml
2. 設定を変更
色、フォント、間隔などを調整するためにYAMLファイルを編集します。詳細については、設定ガイドを参照してください。
3. カスタムプリセットを使用
docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
input.md -o output.docx -c config/custom/my-style.yaml
ベストプラクティス
フォントサイズの選択
- 10pt：コンパクト、技術文書
- 11pt：標準的な読みやすさ
- 12pt：読みやすさ向上、プレゼンテーション
行間の選択
- 1.0倍：非常にコンパクト（推奨されません）
- 1.4倍：コンパクトな技術文書
- 1.5倍：標準的な読みやすさ ✓
- 2.0倍：高い読みやすさ、アクセシビリティ
配色
プロフェッショナル：
- ネイビー/ブルー/グレー（defaultプリセット）
- 黒/ダークグレー（minimalプリセット）
テクニカル：
- ダークグレー/ブルーアクセント（technicalプリセット）
- 控えめなハイライトのモノクローム
クリエイティブ：
- カスタムカラーパレット（独自作成）
トラブルシューティング
プリセットが見つからない
問題：Preset 'xxx' not found
解決方法：
- プリセット名がファイル名（
.yamlなし）と一致することを確認 --preset-dirが正しいディレクトリを指していることを確認- 現在のディレクトリからの絶対パスまたは相対パスを使用
例：
# 正しい
docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
input.md -o output.docx -p default --preset-dir /app/config/presets
# これも正しい
docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
input.md -o output.docx -c /app/config/presets/default.yaml
フォントがレンダリングされない
問題：出力ドキュメントでフォントが異なって表示される
解決方法：
- Dockerイメージを使用（フォント埋め込み済み）✓
- Notoフォントをシステムにインストール（.NET CLI使用時）
- YAMLのフォント名が利用可能なフォントと一致することを確認
縦書きテキストの問題
問題：縦書きテキストが正しく表示されない
確認事項：
vertical-novelプリセットまたはカスタム設定でTextDirection: "Vertical"を使用- ドキュメントビューアが縦書きテキストをサポート（Microsoft Word、LibreOffice）
- 日本語フォントが利用可能（Noto Serif CJK JP）
次のステップ
- 設定ガイド - カスタムスタイルの作成方法を学ぶ
- APIドキュメント - md2docxをライブラリとして使用
- GitHubリポジトリ - ソースコードと例
リファレンスファイル
すべてのプリセットファイルはリポジトリで利用可能です：
config/presets/minimal.yamlconfig/presets/default.yamlconfig/presets/technical.yaml
詳細なスタイリング仕様については、完全なソースファイルを参照してください。
最終更新: 2026-02-25