AI出力フォーマット革命 — Claude CodeチームがMarkdownを捨てHTMLを選ぶ理由
この記事の概要
| 項目 | 内容 |
|---|---|
| 対象読者 | 中小企業の経営者・DX担当者、生成AIを業務に取り入れている／これから取り入れる方 |
| 対象テーマ | AI出力フォーマット、業務文書の品質、Atomic DX™ |
| 想定読了時間 | 約10分 |
| 最終更新 | 2026年5月16日 |
| 元ソース | Anthropic Claude Codeチーム Thariq Shihipar 投稿（2026/5/8、X累計1,240万閲覧） |
イントロ：AIが書く文書、誰がどう読むか
2026年5月、Anthropic で Claude Code を開発する Thariq Shihipar 氏が「Markdownの時代は終わった。AIにはHTMLを書かせよ」という主旨の投稿を公開しました。投稿は1週間で1,240万閲覧・16,400いいねを集め、AI業界の文書フォーマット論争に火をつけています[1]。
これまで、ChatGPTもClaudeも、回答の標準フォーマットはMarkdownでした。見出し・箇条書き・コードブロックを軽量に表現でき、開発者にもプレーンテキストとして読みやすい。しかしAIが「ドラフトを書く道具」から「完成物を仕上げる道具」に進化するにつれ、Markdownの限界が露呈し始めています。
本記事では、この海外発の議論を中小企業の経営者・DX担当者向けに翻訳します。技術トレンドの紹介で終わらせず、Kanau Tech™ が提唱する Atomic DX™ 方法論 の観点から、「AI出力を誰がどう読むか」を第一原理で再設計する視点を提供します。
1. 何が起きているか：Claude Codeチームの選択
Thariq 氏の主張を一文で要約すると、こうなります。
「Markdownは下書きには良いが、人間が読む完成物はHTMLであるべき。」
実際、彼は社内文書・PRレビュー・設計案・週次報告のほぼ全てを、Claude Code にHTMLファイルで生成させています。理由はシンプルで、「100行を超えるMarkdownファイルは誰も読まない」「色も図もない文書は理解されない」「Markdownはメールに添付しにくくシェアしづらい」という、極めて実務的な問題でした[1]。
この動きはAnthropic内部に留まらず、ベトナム発のテック解説誌でも4アプローチに整理して紹介され[2]、さらに nexu-io/html-anything というOSSツール（Markdown/CSV/JSON/SQLをローカルAIエージェントでHTMLに変換）も登場[3]。「AI出力フォーマットの主役交代」というテーマで、エンジニア界隈の議論が一気に加速しています。
2. なぜMarkdownでは限界なのか — 5つの理由
中小企業の現場感覚に翻訳すると、Markdownの限界は次の5点に集約されます。
2-1. 「100行の壁」で読まれなくなる
AIに業務マニュアルや提案書を生成させると、すぐに数百行のMarkdownになります。しかし、スクロールが必要な長文Markdownを最後まで読む人はほぼいないのが現実です。Thariq 氏自身も「自分の組織で100行超のMarkdown仕様書を読む人を見たことがない」と告白しています[1]。
2-2. ASCII図という苦肉の策
AIが構造を伝えたい時、Markdownでは罫線文字（├─ └─）でツリー図を描くしかありません。読みやすいとは言えず、コピペすると崩れる。**「AIが頑張って描いた図を、人間が解読する」**という本末転倒が起きています。
2-3. 色をUnicodeで表現する涙ぐましさ
Markdownには色情報がないため、Claudeが「赤いボタン」を表現する時、🔴 のような絵文字を使うことすらあります。デザインレビューがUnicode絵文字頼りという状況は、AIの能力を全く活かしきれていません。
2-4. 共有のしにくさ
.md ファイルはブラウザでそのまま開けません。Slackに貼れば素のテキストとして表示され、メール添付してもクライアントによっては崩れる。**「読まれる前にハードルがある」**フォーマットです。
2-5. 編集機会の喪失
Markdown最大の利点だった「人間が手で書く・直す」という前提自体が崩れています。実際にはAIが書いて、AIに直させるのが標準になり、人間が編集する局面はほぼゼロ。だとすれば、人間が編集しやすいことを最優先に設計されたMarkdownを使う理由は、もはや薄いのです。
3. HTMLが解く問題 — Thariq氏が挙げる5つの優位性
ではHTMLは何が違うのか。Thariq 氏は5つの軸で整理しています[1]。
3-1. 情報密度（Information Density）
HTMLは見出し・段落だけでなく、表・SVG図・コードハイライト・画像・スクリプト・絶対配置まで表現できます。「AIが伝えたい情報のほぼ全てを、効率よく表現できる」入れ物です。
3-2. 視認性（Visual Clarity）
Markdownでは100行で限界だった文書も、HTMLならタブ・カラム・カード・モバイル対応レイアウトで構造化できます。**「読み手が情報を見つけやすい」**設計が可能です。
3-3. 共有容易性（Ease of Sharing）
.html ファイルはS3やGoogle Driveに置けば、URLひとつで誰でもブラウザで開けます。社内・社外問わず、共有のハードルが劇的に下がります。
3-4. 双方向インタラクション（Two-way Interaction）
HTMLは静的な読み物に留まりません。スライダー・ボタン・フォームを埋め込めば、読者が値を調整→結果を確認→そのままAIに戻すという対話的なワークフローが成立します。Thariq 氏は「コピー&ペーストでプロンプトに戻すボタン」を多用していると言及。
3-5. データ取り込み（Data Ingestion）
Claude Code のようなツールは、ローカルファイル・Git履歴・Slack・Web・データベースを横断的に読み込みます。この豊富な文脈をHTMLという表現力豊かなキャンバスで返せることが、生産性のレバレッジを生んでいます。
4. トレードオフを直視する
HTMLが万能なわけではありません。Thariq 氏自身も誠実に欠点を開示しています[1]。
| 項目 | Markdown | HTML | 影響 |
|---|---|---|---|
| トークン消費 | 少ない | 2〜4倍 | API利用料が増える |
| 生成時間 | 早い | 2〜4倍 | 即応性が下がる |
| Git diff | 読みやすい | ノイズが多い | バージョン管理が辛い |
| 編集容易性 | 高い | 低い | 手直しは現実的でない |
ただし、Anthropic の最新モデル Claude Opus 4.7 は100万トークンのコンテキスト窓を持ち、Thariq 氏は「コンテキスト消費の増加は実用上ほぼ気にならない」と述べています。中小企業の文脈でも、「読まれない長文Markdownを大量生成する」より、「読まれるHTMLを少数生成する」方が経済合理性は高いケースが多いはずです。
5. ツール紹介：html-anything（OSS）
この動きを後押しするOSSとして、nexu-io/html-anything が公開されています[3]。
| 特徴 | 内容 |
|---|---|
| 設計思想 | ローカルファースト（クラウド送信なし） |
| 対応AI CLI | Claude Code / Cursor / Codex / Gemini CLI / GitHub Copilot CLI / OpenCode / Qwen Coder / Aider の8種を自動検出 |
| APIキー | 不要（既存のAI CLI認証を流用） |
| 収録スキル | 75種（記事・スライド・履歴書・ポスター・データレポート・動画絵コンテ等） |
| 入力形式 | Markdown / CSV / JSON / SQL |
| 出力 | 1クリックでWeChat/X/Xiaohongshu/Zhihu/独立HTML/PNGに変換 |
「AIが書いたMarkdownを、別のAIエージェントが読みやすいHTMLに仕上げる」というワークフローを、ローカル環境で完結できる点が特徴です。Kanau Tech™ としては中立的に紹介する立場ですが、ローカル完結・APIキー不要という構成は、機密情報を扱う中小企業との親和性が高いと評価できます。
6. 中小企業の実務応用 — 4つの活用シーン
ここからが本題です。海外エンジニアの議論を、中小企業の業務にどう翻訳するか。Kanau Tech™ が現場で考える応用先は以下の4つです。
6-1. 経営会議・取締役会の月次報告
PDF・Wordで作成する月次報告を、AIにHTMLで生成させる。グラフは静的画像ではなくSVGで埋め込めば、社内Webサーバーやクラウドストレージに置くだけで、役員はスマホでも開けます。「印刷して配る」前提を捨てるだけで、紙コスト・郵送コスト・修正リードタイムが大幅に圧縮されます。
6-2. 顧客向け提案書・見積書
提案書をHTMLで作れば、URLひとつで送付・閲覧履歴の取得・スマホ最適表示が可能になります。「PDFを開かせる」より「リンクをクリックさせる」方が圧倒的にCVRが高いのは、Webマーケティングでは常識。これを社外文書にも適用するのが次のステップです。
6-3. 社内マニュアル・業務手順書
業務手順書こそHTMLの真価が出る領域です。検索・索引・タブ切替・モバイル対応・チェックリスト機能を盛り込めば、現場スタッフが「読む」から「使う」へ変わります。介護・飲食・士業など、現場と本部の情報非対称を抱える業界で特に効果が大きいでしょう。
6-4. 議事録・ナレッジ蓄積
会議録音 → 文字起こし → Claude等で要約 → HTML出力、というワークフローを組めば、議事録が検索可能なナレッジベースに育ちます。MarkdownのままGitに沈ませる運用と、HTMLで社内Wikiに公開する運用では、半年後の活用度に決定的な差が出ます。
これらの応用は、2026年版 中小企業のための生成AI業務活用 完全ガイド で整理した「AIを業務フローに組み込む」原則とも整合します。
7. Atomic DX™ 観点 — 「誰が読むか」を第一原理で問い直す
ここで一段抽象度を上げます。Kanau Tech™ が提唱する Atomic DX™ 方法論 は、業務を最小単位に分解し、第一原理思考で再設計するアプローチです。AI出力フォーマット選びにこれを当てはめると、問いはひとつに集約されます。
「この文書を、最終的に誰が、どんなデバイスで、何のために読むのか？」
| 読み手 | 用途 | 最適フォーマット |
|---|---|---|
| 開発者・AI自身 | コード反映、再プロンプト | Markdown |
| 経営者・営業 | 意思決定、レビュー | HTML |
| 現場スタッフ | 業務手順の参照 | HTML（モバイル対応） |
| 顧客・取引先 | 提案・契約検討 | HTML or PDF |
つまり、「全部Markdown」も「全部HTML」も思考停止であり、Atomic DX™ の発想では「読み手と用途のマトリクスに応じてフォーマットを設計する」のが正解です。Thariq 氏の主張も、その文脈で読めば「完成物を読む人間が増えたから、HTMLの比重を上げよ」というメッセージとして理解できます。
8. 明日から始める3ステップ
最後に、この議論を明日から実務に取り入れるための3ステップを提示します。
ステップ1：対象業務を1つ選ぶ
いきなり全文書をHTML化する必要はありません。まずは「社内で最も読まれていない文書1つ」を選びます。月次報告書、業務マニュアル、顧客提案書のどれかが候補になるはずです。
ステップ2：AIで試作する
Claude / ChatGPT / Gemini のいずれかに、「この文書をHTMLで作って。見出し・表・色付き強調・モバイル対応を含めて」とプロンプトを送ります。出力された .html ファイルをブラウザで開き、Markdown版と比較して、読み手の反応の違いを計測します。
ステップ3：テンプレ化して標準運用へ
良い結果が出たら、フォーマットをテンプレ化し、社内の標準ワークフローに組み込みます。Claude Code 導入ガイド で紹介している CLAUDE.md 規約に「この種の文書はHTMLで生成」というルールを追記すれば、属人化を防げます。
まとめ：技術トレンドを「届く形」に翻訳する
Thariq 氏の投稿は、表面的には「HTMLを使え」という技術的提言ですが、本質は「AI出力を誰がどう読むか、を第一原理で考え直せ」という業務設計の問いかけです。中小企業の現場では、AIが書いた長大なMarkdown文書がGitやNotionに眠ったまま、誰にも読まれていないケースが少なくありません。
「AIで何を生成するか」より、「生成物を誰がどう受け取るか」を起点に設計すれば、同じAI投資でも成果は何倍も変わります。これこそが、Kanau Tech™ が掲げるタグライン 「技術は、届いてこそ価値になる。」 の意味するところです。
Kanau Tech™ では、Atomic DX™ 方法論に基づき、中小企業の業務文書ワークフローをAI前提で再設計する伴走支援を提供しています。「AIで作っているのに、結局誰も読まない」という違和感を感じている経営者・DX担当者の方は、お問い合わせフォーム からお気軽にご相談ください。
出典・参考リンク
[1] Thariq Shihipar (@trq212), "Using Claude Code: The Unreasonable Effectiveness of HTML", X (旧Twitter), 2026年5月8日, https://x.com/trq212/status/2052809885763747935（2026年5月16日閲覧）
[2] Phong Minh Ho, "HTML hay Markdown cho AI? — 4アプローチ比較", phongminhho.substack.com, 2026年5月, https://phongminhho.substack.com/p/html-hay-markdown-cho-ai（2026年5月16日閲覧）
[3] nexu-io, "html-anything: Agentic HTML Editor", GitHub, https://github.com/nexu-io/html-anything（2026年5月16日閲覧）
関連記事
- 2026年版 中小企業のための生成AI業務活用 完全ガイド — IT導入補助金・AI規制・業界別事例まで一次ソース付きで網羅
- Atomic DX™ 方法論：第一原理思考で業務を再設計する — Kanau Tech™ が提唱するDX再設計フレームワーク
- 中小企業のためのClaude Code導入ガイド — AIエージェント時代の開発・業務自動化の始め方