baserproject Markdown to HTML
Markdown を HTML に変換するためのスキル。
When to use
- ユーザーが Markdown を HTML に変換したい
.mdファイルから HTML ファイルを作りたい- 本文だけの HTML 断片、またはブラウザで開ける完全な HTML 文書が必要
Workflow
- 入力がファイルなら中身を確認する。文字列ならそのまま扱う。
- 変換は
scripts/md_to_html.pyを優先して使う。 - デフォルトでは完全な HTML 文書を出力する。
- HTML 断片が必要な場合は
--fragmentを付ける。 - タイトル指定があれば
--titleを使う。なければ入力ファイル名か既定値を使う。 - 出力後に見出し、箇条書き、コードブロック、リンクが崩れていないか軽く確認する。
Commands
ファイルを HTML 文書へ変換:
python3 scripts/md_to_html.py input.md -o output.html --title "Document Title"
標準入力から HTML 断片を生成:
printf '# Hello\n\n- one\n- two\n' | python3 scripts/md_to_html.py --stdin --fragment
Notes
- 外部ライブラリなしで動く軽量実装。
- 対応する主な記法: 見出し、段落、箇条書き、番号付きリスト、引用、コードフェンス、インラインコード、強調、リンク、画像、水平線、Markdown テーブル。
- 複雑な Markdown 拡張記法や厳密な CommonMark 完全互換が必要な場合は、その制約をユーザーに共有したうえで対応範囲を明示する。