できない.dev

Tailwind CSS の prose クラス(typography プラグイン)が適用されない

Tailwind CSS の prose が適用されないときは、@tailwindcss/typography を入れて登録すれば直る。
v3 は config の plugins、v4 は CSS の @plugin で読み込む。

公開: 更新:

症状できない · exit 1
grep -c prose out.css
0

2026-11-19 に node:20(Tailwind CSS 3.4.19 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

prose は Tailwind 本体ではなく @tailwindcss/typography(新しいタブで開く) プラグインで定義されるクラスである。
主な原因は、プラグインが未導入か、設定ファイルへの登録漏れか、content のスキャン対象外で purge されているかのどれかである。
Tailwind v3 と v4 では導入方法が違う。

実行例

実際に node:20 で動かすと、プラグインを入れる前のビルド結果には prose を含む行が 1 つも無く、@tailwindcss/typography を追加して再ビルドすると 196 行に増える。
lg:prose-xl も同じ再ビルドで 48 行出力されるので、レスポンシブの派生クラスまでプラグイン側が供給していることが分かる。

$ npx tailwindcss -i src/input.css -o out.css
Browserslist: caniuse-lite is outdated. Please run:
  npx update-browserslist-db@latest
  Why you should do it regularly: https://github.com/browserslist/update-db#readme
 
Rebuilding...
 
Done in 105ms.
$ grep -c prose out.css
0
$ echo $?
1
$ npm install --silent --no-save @tailwindcss/typography
$ npx tailwindcss -i src/input.css -o out.css
Browserslist: caniuse-lite is outdated. Please run:
  npx update-browserslist-db@latest
  Why you should do it regularly: https://github.com/browserslist/update-db#readme
 
Rebuilding...
 
Done in 201ms.
$ grep -c prose out.css
196
$ grep -m3 -A2 -F ".prose {" out.css
.prose {
  color: var(--tw-prose-body);
  max-width: 65ch;
--
.prose {
  --tw-prose-body: #374151;
  --tw-prose-headings: #111827;
$ grep -c -F 'lg\:prose-xl' out.css
48

— 2026-11-19 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-11-19 検証(ほか 2 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5
  • Tailwind CSS 3.4.19

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. プラグインを追加する

npm install -D @tailwindcss/typography

2. v3: tailwind.config.js の plugins に登録

// tailwind.config.js
module.exports = {
  content: ["./src/**/*.{html,js,ts,jsx,tsx,md,mdx}"],
  plugins: [require("@tailwindcss/typography")],
};

3. v4: CSS で @plugin を宣言

Tailwind v4 では設定ファイルが任意になり、CSS 側で plugin を読み込む。

/* app.css */
@import "tailwindcss";
@plugin "@tailwindcss/typography";

4. content パスを広げる

prose を実際に付けるテンプレートやレイアウトファイルを v3 では content、v4 では @source に含める。
Markdown 内部に書いた class はスキャンされないので、ラッパー側 (<article className="prose">{children}</article>) で付与すると確実に効く。

よくある原因

  1. @tailwindcss/typography を npm install しておらず、プラグインが入っていない。
  2. v3 で、tailwind.config.js の plugins 配列にプラグインを追加し忘れている。
  3. v4 で @plugin が漏れている。
    CSS-first 設定で @plugin ディレクティブを書いていない。
  4. content のスキャン対象から外れている。
    Markdown 経由で prose を付ける場合、ラッパー側テンプレートにクラス文字列が無いと purge される。