publish-md 使い方

このフォルダに .md ファイルを置くと、数秒後に web で閲覧できる HTML に自動変換されます。

仕組み

• 監視: macOS の launchd (OS 標準の常駐タスク管理) がこのフォルダを WatchPaths で監視
• 変換: .md が追加・更新されると ~/.claude/scripts/generic-convert-md.sh が発火し、marked (Markdown→HTML 変換ツール) でパース → Zenn 風ダークテーマのテンプレートに流し込み
• 公開: 生成された HTML は ~/plan-viewer/ に配置され、Tailscale Funnel (Tailscale の外部公開機能) 経由で次の URL で閲覧可能

👉 http://mbp.tail863a2a.ts.net:8765/

使い方

1. このフォルダ (~/publish-md/) に好きな名前の .md ファイルを置く
2. 数秒待つ
3. 上記 URL の index ページに新しいエントリが現れる

注意

• .md の最初の # 見出し がページタイトルになります (なければファイル名)
• 同じ日に同じタイトルで何度編集しても、同日分の HTML に上書きされます
• 翌日編集すると別ファイルとして履歴が残ります
• README.md 自身もこの仕組みで公開対象になります (消しても自動再生成はされません)

ログ

• /tmp/md-auto-publish.out.log
• /tmp/md-auto-publish.err.log