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