ルールの一覧へ

画像の代替テキストがファイル名

image-file-name-alt既定で動く日本語 / 英語

「![IMG_1234.png](…)」のように、代替テキストがファイル名のままの画像

例

指摘される文
四月から六月の売上です。 ![IMG_2041.png](IMG_2041.png)
chaff の出力
3:1 画像の代替テキスト「IMG_2041.png」はファイルの名前です
直した文
四月から六月の売上です。 ![四月から六月の売上の推移](IMG_2041.png)
chaff の出力
指摘なし

直し方

画像が伝えることを一言で書いてください(![4月の売上の推移](IMG_1234.png))。

なぜ指摘するのか

「![IMG_1234.png](IMG_1234.png)」「![スクリーンショット 2026-04-01](a.png)」のように、代替テキストが画像のファイル名のままの所です。画像が読み込めないときと画面読み上げで読むときは代替テキストだけが画像の代わりに伝わりますが、ファイル名は何が写っているかを言いません。画像を貼った道具が名前を入れたまま残ったものがほとんどです。代替テキストが空の画像は image-alt-text が指します。

指摘しないもの

画像の拡張子で終わらず、カメラや画面の撮影が付ける名前でもない代替テキスト(![構成図](diagram.png))は指しません。名前の始まりは言語の語彙表 image-file-name が言います。引用(>)とコードの中の画像も見ません。

止める・ゆるめる

この一か所だけ黙らせる(文書に書く)
<!-- stet: image-file-name-alt — 理由 -->
チームでゆるめる(理由は chaff.yaml にコメントで残ります)
npx chaffjs relax image-file-name-alt --why "理由"
チームで止める(chaff.yaml)
rules: image-file-name-alt: off
技術的な情報
層
L1
状態
安定
重さ
注意
対象の言語
日本語と英語
向いている文章
business, technical, blog, legal, docs, academic, literature, speech
文書から読み取るもの
markdown

強さ(段階)

chaff.yaml の rules にこの名前と段階を書くと変わります。書かなければ、ジャンルが決めた段階で動きます(どのジャンルで動くかは下の「ジャンルごとの動き」にあります)。

strictエラー
normal注意
relaxed情報

このルールには数える上限がありません。段階は指摘の重さを変えます。relaxed にすると指摘は消えずに一段軽く出ます。

ジャンルごとの動き

既定で動くジャンル
technical/spec, technical/readme, blog/tech, blog/essay, blog/owned-media, business/proposal, business/report, business/email, business/press-release, business/meeting-notes, legal/contract, legal/statute, legal/judgment, legal/patent, docs/manual, docs/faq, docs/glossary, academic/paper, literature/fiction, literature/essay, literature/poetry, literature/play, speech/address, speech/transcript

ジャンル

指摘の文

画像の代替テキスト「{alt}」はファイルの名前です

書き直しの深さ(chaff fix-plan --depth): light — 語と文を直す。構成と文体は残す

このページはルールの定義ファイルから作られています:packages/chaff/rules/image-file-name-alt.yaml