Files

67 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` が生成されます。