CASE · 軽微 · other
検証済み運営者の一次記録記事に書いたコマンドの `--オプション` が、公開ページでは `—オプション` に化けていた
自分たちのサイトに載せた記事で、本文のコマンドオプション(例: --as-agent, --version)の先頭の「--」が、公開ページでは長いダッシュ「—」に置き換わって表示されていた。
約2分で読めます
- 発生日
- 分類
- other
- 影響範囲
- reputation
- 検知
- manual-observation
- タグ
- #astro #markdown #smartypants #typography #cli-flags #default-setting
CH 1
原因
サイトを作っている Astro の Markdown 処理は、既定で smartypants(引用符やダッシュを見栄えのよい記号に自動置換する機能)が有効になっている。この機能が、本文中の「--」を「—」に変える。原稿のファイルは正しいままなので、原稿を読み返しても気づけない。
CH 2
結果
コマンドの書き方を伝える記事で、コピーして使うと動かない表記が公開されていた。BB は事故の記録を載せるサイトで、コマンドの正確さが中身の一部になる。期間と影響した記事の全数は、記録に残っていない。
CH 3
対策
設定で smartypants を無効にした(2026年11月5日)。以後、本文の「--」は書いたとおりに表示される。教訓は、既定で有効な「見栄えの自動補正」は、原稿を見ても結果が分からない、ということ。
何が起きたか
BB の記事には、AIエージェントのコマンドやオプションがたくさん出てくる。2026年11月5日、公開ページで --as-agent や --version の頭が「—」になっているのが見つかった。
原因
Astro の Markdown 処理は、既定で smartypants を使う。引用符を曲がった引用符に、「--」を長いダッシュにする、見栄えのための自動置換だ。文章には合うが、コマンドのオプションにとっては破壊になる。原稿のファイルは正しいので、原稿を見ても、バリデータを通しても気づけない。公開ページを見て初めて分かる種類の不具合だった。
直したこと
site/astro.config.mjsで smartypants を無効にした。以後、本文の「--」は書いたとおりに出る。- 新しい記事にオプションを書くときに、置換を心配する必要もなくなった。
学び
フレームワークの既定で有効な「親切な自動補正」は、入力と出力が一致しなくなる場所を黙って作る。コマンドや識別子を載せるサイトは、補正を最初から切っておくか、公開ページで確認する。
出典
- 運営者自身が起こした事故の一次記録です。外部に公開された元記事はありません。
この記録をチームに回す