mcpField
M
md-render

md-render

github.com/hjewkesドキュメント468 回インストール36 週間前に更新
リポジトリ

md-render について

Markdown ファイルをダークモードの HTML に変換するコマンドラインスキルで、結果をブラウザーで開くこともできます。スタイル設定、図表、コードハイライトに対応し、エージェントが生成した文書を単独の HTML として出力できます。

主な機能

  1. 01Markdown から HTML への変換
  2. 02変換結果をブラウザーで表示
  3. 03HTML 保存と標準入力の読み込み
  4. 04色、フォント、レイアウトの設定
  5. 05Mermaid 図表とコードハイライト
  6. 06レスポンシブ表示と操作可能な目次

活用シーン

  1. 01計画書やレポートのプレビュー
  2. 02Markdown の HTML ファイルへの保存
  3. 03図表やコードを含む文書の閲覧

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hjewkes/agent-skills --skill md-render

インストール後、Claude Code で/md-renderを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

package-lock.json
package.json
defaults/
config.json
scripts/
md-render
src/
render.mjs
templates/
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.htmlHTML をファイルに保存
md-render file.md --no-openブラウザーを開かずに HTML を生成
md-render -c path.json file.md別の設定を使用
md-render --help使い方を表示

終了コード: 0 = 成功、1 = エラー

レンダリング機能

  • 設定可能な色、フォント、サイズを備えたダークモードのデザイン
  • 折りたたみ可能な目次(インライン表示とスライドアウトパネル)
  • クリップボードにコピーするボタン付きのシンタックスハイライトされたコードブロック
  • Markdown ソース全体をコピーするボタン(右上)
  • クリック可能な見出しアンカー(ホバー時に表示)
  • Mermaid 図のレンダリング(フローチャート、シーケンス図、状態遷移図、円グラフ)
  • タスクリストのチェックボックス、脚注、==ハイライト==、subscript/super^script^
  • 絵文字のショートコード(:rocket: :white_check_mark:)
  • {#id .class} によるカスタム属性
  • レスポンシブレイアウト
  • 自己完結型 HTML(有効な場合、mermaid は CDN を使用)

設定

設定ファイルの場所:~/.config/agent-skills/md-render/config.json

初回実行時にデフォルト設定から自動作成されます。カスタマイズするには編集してください:

  • theme — 色、フォント、サイズ、最大幅
  • features — toc、シンタックスハイライト、見出しアンカー、mermaid、ブラウザーで開く機能の切り替え

コメント