「Markdownをやめろ」は本当か？──Claude Code記事の煽りに踊らされないために、原典を正確に読む
過剰な煽りタイトルから始まった違和感
先日、Xで「Claude CodeでMarkdown（マークダウン）を使っているのは99%の素人。それやめろ」という趣旨の日本語記事が流れていました。
Anthropicの中の人が「もうMarkdownではなくHTMLで出力した方が圧倒的にいい」と語った！、Claude Code時代の最適解はHTMLファーストだ！……といったトーンの記事です。記事では「11000万View超えの大バズ」と紹介されていた元記事を読む前に、まず違和感がありました。
Web制作・システム開発に30年携わってきた立場からいえば、HTMLとMarkdownは文書構造を示す情報としてほぼ等価です。HTMLにおけるidやclassは、ある程度の構造を示しはするものの、その多くは表現装飾のための情報です。
それ以外の主たる要素である<h1>と# 見出し、<ul><li>と- リスト項目、<strong>と**強調**──これらは1対1で対応させられます。ですので、「意味伝達」という観点では、両者に決定的な差異はないはずなのです。
HTMLが「HyperText Markup Language」であり、その中に「Markup（マークアップ）」が含まれているように、HTMLにおける装飾を全て除外して、いわゆる「文書構造」の提示として考えたら、Markdownとなんら変わらないのは、HTMLを書く人なら十分に理解できる話だと思います。
つまり、HTMLがMarkdownに本質的に勝るとすれば、それは「画像、JavaScript、UI、モックアップ」といった視覚表現とインタラクションの領域に限定されるはずであり、それ以外で「Markdownはやめるべき」と断言できる根拠は、論理的に成立しないはずだよな……というのが違和感の部分です。
そう考えて、紹介記事が引用していた元記事──Anthropic Claude CodeチームのThariq氏が書いた「Using Claude Code: The Unreasonable Effectiveness of HTML」を読みにいきました。
原典は「Markdownをやめろ」と言っていない
結論から書く。原典のThariq氏は、日本語紹介記事が伝えるような断定的・扇動的な主張を一切していませんでした。
Thariq氏が書いているのは、こうである。
"I've started preferring HTML as an output format instead of Markdown and increasingly see this being used by others on the Claude Code team, this is why."
「私はHTMLを出力フォーマットとして好むようになった」。これが原典の冒頭の宣言です。決してMarkdown絵の記述を「やめろ」とも言っていないし、HTMLが「最適解だ」とも言っていない。あくまで「自分の好み」として書かれている。
さらに、Thariq氏は自分のスタンスについて、こう正直に書いている。
"I have honestly stopped using markdown altogether for almost everything, but I'm probably far on the HTML maximalist side of things."
「私はほぼすべてでMarkdownを使うのをやめたが、おそらくHTMLマキシマリスト側に振れすぎている」。
本人が「自分は極端な側にいる」と自覚した上で書いている個人的見解なのである。
紹介記事が「Anthropicの中の人が公式に語った」かのように受け取れてしまう演出的な文章になっているが、実際には個人ブログの個人見解にすぎない。Anthropicの公式推奨でもなければ、Claude Codeチームの統一見解でもない。
原典が認めている「弱点」を紹介記事は薄めている
さらに重要なのは、Thariq氏自身が原典でHTMLでつくることの「弱点」を明確に認めている点である。
FAQセクションを読むと、以下が率直に書かれている。
トークン効率について：
"While markdown often uses fewer tokens, I've found that the added expressiveness of HTML..."
Markdownの方がトークン消費が少ないことを認めている。
生成時間について：
"This does take longer! HTML can take 2-4x longer than Markdown..."
HTMLは2〜4倍時間がかかることを明言している。
バージョン管理について：
"This is honestly one of the biggest downsides of HTML, HTML diffs are noisy and hard to review compared to Markdown."
「HTMLの最大の弱点の一つ」とまで書いている。diffがノイズだらけでレビューしづらい、と。
これらのトレードオフを誠実に書いた上で、「それでも自分の用途では価値がある」というのが原典の論調だ。
日本語紹介記事ではこれらの弱点が「よくある疑問」として軽く流され、「断言します。Claude Code時代の最適解はHTMLファーストです」という煽り文に押しつぶされている印象があります。
原典が挙げる用途は「視覚化が必要なもの」に偏っている
Thariq氏が "Use Cases" として挙げている事例を冷静に分類すると、興味深いことがわかります。
複数案の並列比較（6案をグリッドで並べる）
コードレビュー（diffに注釈、色分け）
デザインプロトタイプ（スライダーでアニメーション調整）
リサーチレポート（SVGでフロー図、データフロー）
カスタム編集UI（Linearチケットのドラッグ&ドロップ並び替え）
これらすべてに共通するのは、視覚的構造化・図解・インタラクションが本質的に必要な成果物であることです。
純粋なテキスト文書、たとえば散文の仕様書、要件定義の本文、議事録、ブログ記事──こうしたものはThariq氏の例にほぼ含まれていない。
つまり原典を正確に読むと、HTMLが優位なのは「画像、JavaScript、UI、モックアップ、視覚的構造化が必要な領域」に限定される、という当たり前の結論に着地する。これはHTMLを30年扱ってきた人間なら直感的に理解できる範囲の話であり、煽るほどの新規性はない。
Thariq氏自身が原典の冒頭で示している例も示唆的だ。Claude CodeがMarkdown内で色を表現しようとして、Unicode文字で頑張った結果のスクリーンショットを載せている。
要するに「色や図を出したいときにMarkdownは無理がある」という当たり前の話を、丁寧に書いているのが原典である。
さらに重要：「指示」と「出力」を混同してはいけない
原典を読んで改めて気づくのは、Thariq氏が議論しているのはClaude Codeの出力フォーマットであって、Claude Codeへの指示ファイルではないという点だ。
CLAUDE.md、SKILL.md、HANDOVER.mdなど、こうしたAIへの指示ファイルをHTMLにした方がいいという主張は、原典に一切ありません。Thariq氏が言っているのは、Claude Codeが生成する成果物（仕様書、レポート、レビュー資料、プロトタイプ）の話である。
日本語紹介記事を読むと、この区別が良く分からない書き方になっていて曖昧になり、結果として誤読に繋がるような文書になっている。
「Claude Codeへの指示にはHTMLが有益」と読み取れる文脈もあり、これは原典の主張を歪めてしまっています。AIへの指示は自然言語のテキストであり、Markdownで十分機能する。むしろ装飾情報の多いHTMLは、指示の意味伝達を阻害しかねない。
なぜこんな過剰な煽りが生まれるのか…
ここでこの記事を書いた理由でもあるのですが、なぜこういう煽り記事が生まれるのか……
答えは単純で、煽る方がバズるから。
「99%の人は間違っている」「もうMarkdownはやめろ」「断言します」──こういう断定調は、注意を引きやすく、シェアされやすく、フォロワーを増やしやすい。
また、原典が英語の記事なので「URLは書いているし、必要な人はそれを読めばいい……けど読む人はいないだろうし、意訳だから」で全て逃げようと思えば逃げられるから、という理由もあるのではないかと思います。
原典のThariq氏は誠実に、
「自分はHTMLマキシマリスト側だが」
「トークンも時間もかかるが」
「diffは弱点だが」
と但し書きを重ねて書いている。ちゃんと読めば分かりますが、とても誠実な技術記事の書き方と思います。しかし誠実な但し書きは、断定調の煽りに比べてバズり憎いです。（とはいえThariqの今回の記事はアクセス数でいえばバズり倒しているといえますが）。
ただ、地味な書き出し、という意味ではこのブログ記事もきっとバズることもないとは思います（笑）
ただ、文意を変えられた結果として、原典の慎重で誠実な議論は、日本語紹介の段階で「Markdownをやめろ」「HTMLファースト」「断言します」という攻撃的な処方箋に変換されてしまった。
一番大事なこと：原典を読み、煽りに踊らされない
今回の一連の検証を通じて、改めて確認できたことがある。
SNSで流れてくる「断言」「99%」「これさえやれば」「もう〇〇はやめろ」というトーンの記事は、ほぼ例外なく原典を歪めている可能性が極めて高い。
ということです。
原典を読みに行けば、たいていの場合、もっと慎重で、もっと条件付きで、もっと正直にトレードオフが書かれている。今回のThariq氏の記事も、ちゃんと読めば「自分の好みではこうしている、ただしトークン消費も時間もかかるし、diffも弱い」という穏当な内容だった。
技術選択において重要なのは、煽り見出しを見て即断することではなく、原典に当たって自分の業務文脈で判断することだ。
私自身の整理で言えば、CLAUDE.mdやSKILL.md、Obsidianの知識ベース、Git管理する仕様書はMarkdownのまま運用する。一方、クライアント向けの提案資料、プロトタイプ、複数データソースを統合したレポート、視覚的な比較が必要な成果物については、HTMLでの出力が選択肢として有効だろう。これは「Markdownをやめる」という話ではなく、用途に応じてフォーマットを使い分けるという、当たり前の話である。
SNSの煽りに踊らされるのではなく、原典を正確に読み、自分の文脈で判断する。技術選択の本質は、結局そこに尽きるんじゃないかと思っています。
