md-render について
Markdown ファイルをダークモードの HTML に変換するコマンドラインスキルで、結果をブラウザーで開くこともできます。スタイル設定、図表、コードハイライトに対応し、エージェントが生成した文書を単独の HTML として出力できます。
主な機能
- 01Markdown から HTML への変換
- 02変換結果をブラウザーで表示
- 03HTML 保存と標準入力の読み込み
- 04色、フォント、レイアウトの設定
- 05Mermaid 図表とコードハイライト
- 06レスポンシブ表示と操作可能な目次
活用シーン
- 01計画書やレポートのプレビュー
- 02Markdown の HTML ファイルへの保存
- 03図表やコードを含む文書の閲覧
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hjewkes/ agent-skills --skill md-renderインストール後、Claude Code で/md-renderを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
package-lock.jsonpackage.jsondefaults/config.jsonscripts/md-rendersrc/render.mjstemplates/page.html詳細
Markdown レンダラー
Markdown ファイルを美しいダークモードの HTML に変換して、ブラウザーで開きます。エージェントが生成したドキュメント(設計書、計画書、レポート)の閲覧向けに設計されています。
クイックリファレンス
| 状況 | 操作 |
|---|---|
| ユーザーが Markdown のレンダリング/プレビューを求めた場合 | md-render <file> を実行 |
| ユーザーが HTML 出力の保存を希望する場合 | md-render <file> -o output.html を実行 |
| ユーザーがスタイルのカスタマイズを希望する場合 | ~/.config/agent-skills/md-render/config.json を編集 |
| ユーザーが Markdown をパイプで渡したい場合 | echo "# Title" | md-render - |
CLI リファレンス
| コマンド | 説明 |
|---|---|
md-render file.md | レンダリングしてブラウザーで開く |
md-render - < file.md | 標準入力からレンダリング |
md-render file.md -o out.html | HTML をファイルに保存 |
md-render file.md --no-open | ブラウザーを開かずに HTML を生成 |
md-render -c path.json file.md | 別の設定を使用 |
md-render --help | 使い方を表示 |
終了コード: 0 = 成功、1 = エラー
レンダリング機能
- 設定可能な色、フォント、サイズを備えたダークモードのデザイン
- 折りたたみ可能な目次(インライン表示とスライドアウトパネル)
- クリップボードにコピーするボタン付きのシンタックスハイライトされたコードブロック
- Markdown ソース全体をコピーするボタン(右上)
- クリック可能な見出しアンカー(ホバー時に表示)
- Mermaid 図のレンダリング(フローチャート、シーケンス図、状態遷移図、円グラフ)
- タスクリストのチェックボックス、脚注、==ハイライト==、sub
script/super^script^ - 絵文字のショートコード(:rocket: :white_check_mark:)
{#id .class}によるカスタム属性- レスポンシブレイアウト
- 自己完結型 HTML(有効な場合、mermaid は CDN を使用)
設定
設定ファイルの場所:~/.config/agent-skills/md-render/config.json
初回実行時にデフォルト設定から自動作成されます。カスタマイズするには編集してください:
- theme — 色、フォント、サイズ、最大幅
- features — toc、シンタックスハイライト、見出しアンカー、mermaid、ブラウザーで開く機能の切り替え
コメント
Markdown 対応