# MdToHtmlDashboard (汎用Markdown → インタラクティブHTML変換ツール)
任意の Markdown(`.md`)ファイルから、Antigravity IDE の Artifacts と同様(またはそれ以上)のリッチなテーブル整形・目次ナビゲーション・リアルタイム検索・差分ハイライトを備えた **完全自己完結型インタラクティブHTML** を自動生成する .NET 10.0 製の高速変換ツールです。
---
## 🌟 主な特徴
1. **完全自己完結(スタンドアロン)**:
- 外部インターネット接続やCDN(外部CSS/JS)に一切依存せず、生成された単一の `.html` ファイルをダブルクリックするだけで Edge や Chrome 等でいつでも美麗に開けます。
2. **インタラクティブ・テーブル**:
- Markdown内の全テーブルに、列ヘッダークリックによる「昇順/降順ソート機能」および「インクリメンタル検索」を自動付与。
3. **目次(TOC)サイドバーの自動生成**:
- 見出し(H1〜H4)の階層構造を自動解析し、折りたたみ可能な目次ナビゲーションを生成。
4. **差分コード(diff)ハイライト**:
- ````diff` 内の `+`(緑ハイライト)および `-`(赤ハイライト)を行単位で綺麗に色分け。
5. **ワンクリック・コピー機能**:
- 各コードブロックやローカルファイルパスの横に `[📋 コピー]` ボタンを自動付与。
6. **H2セクション単位のアコーディオン展開/折りたたみ**:
- 長大なドキュメントでも見通し良く閲覧可能。
---
## 🚀 使い方
### 方法1: ドラッグ&ドロップ(最も簡単)
1. エクスプローラーで変換したい `.md` ファイルを選択します。
2. 本フォルダ直下にある **`ドラッグ&ドロップでHTML変換.bat`** にドラッグ&ドロップします。
3. 同一フォルダに `.html` ファイルが生成され、自動的にブラウザで開きます。
### 方法2: コマンドライン実行 (CLI)
```bash
# 基本変換(入力ファイルと同じフォルダに .html を出力し自動オープン)
MdToHtmlDashboard.exe document.md
# 出力先パスを指定して変換
MdToHtmlDashboard.exe input.md -o output_report.html
# フォルダ内の全 .md ファイルを一括変換
MdToHtmlDashboard.exe D:\Work\Documents\
# ブラウザの自動起動を抑止
MdToHtmlDashboard.exe document.md --no-open
```
### 方法3: 対話モード
`ドラッグ&ドロップでHTML変換.bat` または `MdToHtmlDashboard.exe` を引数なしでダブルクリックすると、ファイルパスの入力受付またはカレントフォルダ内の `.md` 候補選択メニューが表示されます。
---
## 🛠 開発・ビルド方法 (Visual Studio / .NET 10.0)
- **ソリューションファイル**: `MdToHtmlDashboard.slnx`(Visual Studio 2022 / 2026 で開けます)
- **ターゲットフレームワーク**: `.NET 10.0`
- **主要ライブラリ**:
- `Markdig` (高度拡張Markdownパーサー)
- `HtmlAgilityPack` (DOMエンリッチメント)
### 単一実行ファイル (.exe) の発行コマンド
```bash
cd D:\VS2026_git\自作ツール\MdToHtmlDashboard
dotnet publish MdToHtmlDashboard\MdToHtmlDashboard.csproj -c Release -r win-x64 --self-contained false -o publish
```
上記を実行すると、`publish\` フォルダに高速起動する `MdToHtmlDashboard.exe` が生成されます。