人間がMarkdownを書いたり修正しない時代に、Claude Code hookでドキュメントを自動でファンシーHTML化する

はじめに X 上で見かけた 「もう Markdown じゃなくて HTML でドキュメント書いた方がよくない？」 系の議論（@trq212 のポスト等）には、まったく同感です。 というのも、自分は もう半年ほど前から、Claude CodeにHTMLでドキュメント生成させています。エージェントを使えばつかうほど、その生成物を直接人間が修正することが減るからです。プランファイルがその典型で、プランがまちがっていたらそれはAIに指示して修正させるべきで手動修正するべきではないのです。その理由は手間を減らしたいからではなく、「なぜそう出力されたか」の理由にたちもどって指示しないとAIは同じ間違いをくりかえしてしまうからです。そうすることで人間はAIと思考を共有することができます。 その場合、Markdownは人間が作成も修正することはなくなるわけで、Markdown形式がドキュメントの形式として

[hatahata_chan]

mkdocs使えば解決しそうだけどな。なんか大変ですね

[nakex1]

人間がAIに矯正される世界に近づいている。「『なぜそう出力されたか』の理由にたちもどって指示しないとAIは同じ間違いをくりかえしてしまうからです。そうすることで人間はAIと思考を共有することができます」

[hasiduki]

docxなりxlsxなりせめてpdfじゃないと受け付けない人もいるんですよ！！！！！！！画像がページ区切りで切られたら大惨事なんですよ！！！！！！

[hidari_kiki]

jsonで出力して人間が見る用にビューア作った方が良くない？　あとで試してみよう

[mouki0911]

"もちろんトークン消費が増えるなどデメリットがないわけではない"

[georgew]

Markdownばっかりでレビューしているのは見にくいので不合理、HTMLにすればレビューがより正確に、より短時間でおこなうことができる > これは確かにそうだ。

[misshiki]

Claude CodeのPostToolUse hookで.md生成時にHTML化する実装。Markdownはdiff用に残し、claude -pでインフォグラフィック風HTMLを生成。書く用Markdown、読む用HTMLの二段構えを提案。

[yamadadadada2]

モデリングした図とか概念を整理したときにmermaidよりもhtmlやsvgのほうが圧倒的に見やすいてのはあるね。文章は手直したいからmarkdownがよいのだけど

[tinsep19]

レビュー用のmarkdown拡張とそれをhtml化するツールのセットにした方がトークン効率よいみたいになりそう。

[yoiIT]

markupからmarkdownが生まれた背景から、なにか逆行している感があって面白い。

[kibitaki]

.md書いた瞬間に.htmlを生成する、はいいんだけど、トークン消費いやだとかMacOS専用とか、ならなんで的なのが。読むタイミングがトリガでいいと思ってる（そう動かしてる）。1周回って.html制作知識が活きるの微笑ましい

[jintrick]

「少なくとも、あなたが今開いている Zenn 記事には 「Markdown と HTML の可読性差を測定したデータ」や「AI 時代のドキュメント運用を数値で評価した研究」 は一切出ていない。 」by copilot

[rail44]

他のことにトークン使いたい気がしなくもない

[tettekete37564]

歴史は繰り返す。歴史を学ぶ意義はそこにある

[dalmacija]

htmlなどは人間が編集＝デザイン的選択などから存在しない意図を読み込んじゃうから構造把握には向かないんじゃないかな。人間は構造把握しなくいいいって段階かしら

[kabuquery]

原油依存と同じ過ちを繰り返すのを辞めよう

[mapk0y]

review が大きな問題なら、view を工夫するのじゃだめなのかな。difit での review とかでできそうだけど。AI からの出力自体をリッチにしたいなら厳しいが

[amd64x64]

reST

[yarumato]

“Claude CodeにMarkdown（読みやすくはない。diffなどは有用）ではなくHTML（レビューがより正確に、より短時間に）でドキュメント生成させてる。プランがまちがっていたらAIに指示して修正させるべき。自動でブラウザで開”

[delphinus35]

ちゃんと残したいドキュメントはConfluenceに置くのでどうせ凝った装飾はできないんだよなあ。

[stabucky]

HTMLだと余計な装飾を入れ始めるんだよ。

[hogetax]

この観点ならhtmlである必要すらないのだけど、どの方向に進化するかなぁ

[ejointjp]

プロンプト書くのにmdで書かない？もしかしてmdで書くの時代遅れ？？

[WildWideWeb]

論理と表示の分離という概念に話が発展するのならばTeXとかSGMLとかが先祖だと思うが、そういう話じゃないんだろうね。

[crimson_diamond]

ジョン・コナー「俺は未来からお前を止めにやってきた、みろ、スカイネットの出力を。大量の続きを読む、無限スクロール、そして刺激的だけど✕ボタンが押しにくい広告、これがお前のもたらした未来だ」

[red_kawa5373]

世の中、色んなドキュメント自動生成ツールがあるけど、だいたいのデフォルト設定は、HTML出力が多い気がする。

[kenzy_n]

人はいなくなりました。

[vesikukka]

良さそう。／AsciiDoc+PlantUMLで書いてる。簡易はMarkdoenとMermaid.js。人間にも読めて編集者できるの大事。

[bocuno]

そうだ！mdにスタイル定義出来るようにしよう！

[nguyen-oi]

Markdownはもはや人間が書くものじゃなくAIの「中間生成物」ってことか。レンダリング済みのリッチなHTMLだけ見てればいい時代、意外とすぐ来そう