67 lines
3.5 KiB
Markdown
67 lines
3.5 KiB
Markdown
# 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` が生成されます。
|