npm · #4011

@tailwindcss/typography

0.5.20tailwindlabs/tailwindcss-typography ↗

A Tailwind CSS plugin for automatically styling plain HTML content with beautiful typographic defaults.

Last release 2 months ago
08 Jun 2026
Release timing varies
gaps range from 2 weeks to 7 months
Nearly every release is documented
notes for 30 of 31 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
162 releases · first in 2020

Release timeline

162 releases since 2020

202120222023202420252026

Releases

0.5.208 Jun 2026
Release notes2 sources agree
Fixed
- Support installing with stable versions of Tailwind CSS v4 (#424)
Open source →
0.5.1924 Sept 2025
Release notes2 sources agree
Fixed
- Fixed broken color styles (#405)
Open source →
0.5.1819 Sept 2025
Release notes2 sources agree
Fixed
- Fixed undefined variable error (#403)
Open source →
0.5.1719 Sept 2025
Release notes2 sources agree
Added
- Add modifiers for description list elements (#357)
- Add prose-picture modifier (#367)
Fixed
- Include unit in hr border-width value (#379)
- Ensure <kbd> styles work with Tailwind CSS v4 (#387)
Changed
- Remove lodash dependencies (#402)
Open source →
0.5.167 Jan 2025
Release notes2 sources agree
Fixed
- Support installing with beta versions of Tailwind CSS v4 (#365)
Open source →
0.5.1528 Aug 2024
Release notes2 sources agree
Fixed
- Support installing with alpha versions of Tailwind CSS v4 (#358)
Open source →
0.5.147 Aug 2024
Release notes
- Fix table text alignment (#346)
Open source →
Additional notes
Fixed
- Fix table text alignment (#346)
Open source →
0.5.1326 Apr 2024
Release notes2 sources agree
Fixed
- Don't apply margins to <br> elements contained in an <li> in FF (#350)
Open source →
0.5.1227 Mar 2024
Release notes2 sources agree
Added
- Use logical properties for better RTL support (#323)
Open source →
0.5.1126 Mar 2024
Release notes2 sources agree
Added
- Add prose-kbd modifier (#340)
Fixed
- Fix space between <figcaption> and <video> (#339)
Open source →
0.5.105 Sept 2023
Release notes2 sources agree
Fixed
- Fix space between <figcaption> and <pre> (#313)
- Remove typography styles from not-prose elements in addition to their children (#301)
- Add <picture> styles (#314)
- Fix prose-invert when used with colors in light mode (#315)
- Add <kbd> styles (#317)
- Add description list (<dl>, <dt>, <dd>) styles (#316)
Open source →
0.5.910 Jan 2023
Release notes2 sources agree
Fixed
- Ensure p styles are inserted before .lead styles (#294)
Open source →
0.5.87 Nov 2022
Release notes2 sources agree
Fixed
- Fix selector when using a non-default class (e.g. prose-sm) (#289)
Open source →
0.5.72 Sept 2022
Release notes
Fixed
- Update TypeScript types (#284)
Open source →
Additional notes
Fixed
- Update TypeScript types (#284)
Open source →
0.5.61 Sept 2022
Release notes2 sources agree
- Actually publish types (a54c1a8)
Open source →
0.5.51 Sept 2022
Release notes2 sources agree
Added
- Add typescript types (#283)
Open source →
0.5.412 Jul 2022
Release notes2 sources agree
Fixed
- Update strong and code color styles to inherit from parent (#276)
Open source →
0.5.37 Jul 2022
Release notes2 sources agree
Added
- Add styles for tfoot elements (#243)
- Add prose-h5 and prose-h6 variants (#273)
Fixed
- Fix prose elements legacy mode (#259)
- Allow lead class to override element styles (#260)
- Fix generation of prose-headings variant (#264)
- Fix figure spacing (#267)
- Fix child combinator :where selectors (#268)
- Fix prose-headings variant to include h5 and h6 elements (#273)
Open source →
0.5.214 Feb 2022
Release notes2 sources agree
Fixed
- Ensure nested selectors using &:hover work (#246)
Open source →
0.5.128 Jan 2022
Release notes2 sources agree
Removed
- Remove dist folder and related dependencies (#226)
Fixed
- Don't generate invalid CSS when given an array of property values (#224)
Open source →
0.5.09 Dec 2021
Release notes
This release of @tailwindcss/typography is an exciting one, and finally includes easy support for dark mode, the ability to escape prose styles, and a brand new HTML-based customization API that is a lot more fun to work with than the configuration based API we've offered in the past.

To upgrade, make sure you are on the latest version of Tailwind CSS, then install @tailwindcss/typography@latest:
```
npm install -D @tailwindcss/typography@latest
```
This version is designed for Tailwind CSS v3.0+, and is not compatible with earlier versions.

Added
- Added prose-invert for easy dark mode support (#216)
- Added gray scale modifiers like prose-slate and prose-stone to make it easy to match your typography to your site's gray scale (#216)
- Added new element modifiers API like prose-a:text-blue-500 for easily customizing individual elements directly in your HTML (#216)
- Added not-prose class for preventing prose styles from affecting a section of HTML (#205)
- Updated selectors to use :where to reduce specificity, making it possible to override prose children with utilities (#203)
Changes
- Switch from ::before pseudo-elements to using the native ::marker pseudo-element for styling list bullets and counters (#216)
Open source →
0.5.0-alpha.38 Nov 2021pre-release
Release notes
v0.5.0 will drop support for Tailwind CSS v2.0 and is intended for use with Tailwind CSS v3.0+.

To upgrade, install @tailwindcss/typography@next:
```
npm install -D @tailwindcss/typography@next
```
This is an alpha release, so some things might be broken. I don't know about them otherwise I would have fixed them, but you are gonna find them! So try it, break it, and tell me about it when you do so we can get this thing really battle-tested for a proper v3.0 release in a few weeks.

Changes
- Use :where to reduce specificity, making it possible to override prose children with utilities (#203)
- Support "undoing" prose styles using the not-prose class on a group of child elements (#205)
- Update color palette for v3 (#206)
- Improve customization API, add alternate grays, add dark mode support, use ::marker instead of pseudo-elements, and add child element variants (eg. prose-h1:underline)(#216)
Open source →
Additional notes
Changes
- Use :where to reduce specificity, making it possible to override prose children with utilities (#203)
- Support "undoing" prose styles using the not-prose class on a group of child elements (#205)
- Update color palette for v3 (#206)
- Improve customization API, add alternate grays, add dark mode support, use ::marker instead of pseudo-elements, and add child element variants (eg. prose-h1:underline)(#216)
Open source →
0.5.0-alpha.23 Oct 2021pre-release
Nothing published for this version
0.5.0-alpha.11 Oct 2021pre-release
Nothing published for this version
0.4.124 May 2021
Release notes
Fixed
- Fix list-style modifier selectors (#137)
Open source →
Additional notes
Fixed
- Fix list-style modifier selectors (#137)
Open source →
0.4.015 Jan 2021
Release notes
Fixed
- Colors without 600 variant, breaks everything (#107)
- Fix empty line in firefox for pre code tags (#125)
Added
- Add support for the start and reversed attribute on ol elements (#110)
- Add support for the type on ul and ol elements (#126)
Changed (internal)
- Bumped dependencies (#103, #115)
- Cleanup/improve readme (#95)
- Reduce package size (#112)
Open source →
Additional notes
Fixed
- Colors without 600 variant, breaks everything (#107)
- Fix empty line in firefox for pre code tags (#125)
Added
- Add support for the start and reversed attribute on ol elements (#110)
- Add support for the type on ul and ol elements (#126)
Changed (internal)
- Bumped dependencies (#103, #115)
- Cleanup/improve readme (#95)
- Reduce package size (#112)
Open source →
0.3.118 Nov 2020
Nothing published for this version
0.3.018 Nov 2020
Release notes
This release drops support for Tailwind CSS v1.0.

Some of the changes needed to support Tailwind CSS v2.0 necessitate dropping support for v1.0. You should stay on v0.2.0 until you can upgrade your projects to Tailwind CSS v2.0.

Read the Tailwind CSS v2.0 upgrade guide for information on upgrading your projects.

Changed
- Add support for Tailwind CSS v2.0 and drops support for v1.0 (#79, #82, #87)
- Use extend for any overrides, assigning directly to theme.typography now completely overrides default configuration
- Consistently use ::before instead of :before (ba33d77)
- Read color values from the user's theme instead of only the default theme
Added
- Add new className option for overriding prose class (#28)
- Add color modifiers by default like prose-blue for setting link styles (#92)
Upgrading from v0.2.0 to v0.3.0

This version of the plugin is designed for Tailwind CSS v2.0. Make sure you upgrade Tailwind before upgrading this plugin.

Customizations should be moved under extend, default should become DEFAULT

The biggest difference is that any customizations you had under theme.typography should be moved to theme.extend.typography, and the default key should be uppercased to DEFAULT:
```
  module.exports = {
    theme: {
-     typography: {
-       default: {
-         css: {
-           color: theme("colors.gray.700"),
-           '[class~="lead"]': {
-             color: theme("colors.gray.600"),
-           },
-           a: {
-             color: theme("colors.indigo.600"),
-             fontWeight: 600,
-             textDecoration: "none",
-           },
-         },
-       },
-     },
+     extend: {
+       typography: {
+         DEFAULT: {
+           css: {
+             color: theme("colors.gray.700"),
+             '[class~="lead"]': {
+               color: theme("colors.gray.600"),
+             },
+             a: {
+               color: theme("colors.indigo.600"),
+               fontWeight: 600,
+               textDecoration: "none",
+             },
+           },
+         },
+       },
+     },
    },
  };
```
Any customizations directly under theme.typography will now completely replace the defaults, which is consistent with how theme modification generally works in Tailwind.

Colors are read from theme by default

In previous versions, all of the colors used by this plugin were read from Tailwind's default theme rather than from your theme. The plugin now looks for colors in your theme first, falling back to the defaults if they don't exist. So if the plugin is looking for gray.700 for the main body color, it will use your defined gray.700 if present, or fall back to the default one.

If your colors are totally custom and the numbers don't line up with Tailwind's defaults from a contrast perspective, you probably won't get good results out of the box. In this case you should manually override the colors like you were likely already doing using the existing customization API.
Open source →
0.2.015 Jul 2020
Release notes
- Switches how variants are generated to use the new component variants API in Tailwind 1.5, dropping support for Tailwind < 1.5
Open source →
Additional notes
Changes
- Switches how variants are generated to use the new component variants API in Tailwind 1.5, dropping support for Tailwind < 1.5
Open source →
0.2.0-cb415ad17 Nov 2020pre-release
Nothing published for this version
0.1.415 Jul 2020
Release notes
- Fixes an issue where the lead class was not being applied correctly when used in conjunction with responsive variants
Open source →
Additional notes
Fixes
- Fixes an issue where the lead class was not being applied correctly when used in conjunction with responsive variants
Open source →
0.1.314 Jul 2020
Release notes
- Fixes an issue where the configured monospace font family was not used by default for pre and code blocks
Open source →
Additional notes
Fixes
- Fixes an issue where the configured monospace font family was not used by default for pre and code blocks
Open source →
0.1.213 Jul 2020
Release notes
- Fixes an issue in our internal rounding logic that would round values like 20 to 2 👀
Open source →
Additional notes
Fixes
- Fixes an issue in our internal rounding logic that would round values like 20 to 2 👀
Open source →
0.1.113 Jul 2020
Release notes
- Fixes an issue where the plugin was totally broken and didn't work at all because I deleted some code without even testing my changes 🧠
Open source →
Additional notes
Fixes
- Fixes an issue where the plugin was totally broken and didn't work at all because I deleted some code without even testing my changes 🧠
Open source →
0.1.013 Jul 2020
Release notes
Added
- Everything!
Open source →
0.0.0-insiders.fda8ce58 Jan 2023pre-release
Nothing published for this version
0.0.0-insiders.fb252ec10 Feb 2025pre-release
Nothing published for this version
0.0.0-insiders.fa5beec28 Aug 2024pre-release
Nothing published for this version
0.0.0-insiders.f760acf17 Dec 2021pre-release
Nothing published for this version
0.0.0-insiders.f7510c84 Jul 2022pre-release
Nothing published for this version
0.0.0-insiders.f364a1613 Jun 2024pre-release
Nothing published for this version
0.0.0-insiders.f34283d24 May 2026pre-release
Nothing published for this version
0.0.0-insiders.f2572d817 Dec 2021pre-release
Nothing published for this version
0.0.0-insiders.f06117a7 Jul 2022pre-release
Nothing published for this version
0.0.0-insiders.ee884f330 Aug 2023pre-release
Nothing published for this version
0.0.0-insiders.ed9520619 Sept 2025pre-release
Nothing published for this version
0.0.0-insiders.eaa9d6b1 Feb 2022pre-release
Nothing published for this version
0.0.0-insiders.e7c760f7 Oct 2023pre-release
Nothing published for this version
0.0.0-insiders.e50b74424 Feb 2022pre-release
Nothing published for this version
0.0.0-insiders.e3714a38 Jun 2026pre-release
Nothing published for this version
0.0.0-insiders.e3663405 Sept 2023pre-release
Nothing published for this version
0.0.0-insiders.e21d9e626 Apr 2024pre-release
Nothing published for this version
0.0.0-insiders.e1d4dc722 Mar 2024pre-release
Nothing published for this version
0.0.0-insiders.e0ec24819 Sept 2025pre-release
Nothing published for this version
0.0.0-insiders.e0570447 Nov 2022pre-release
Nothing published for this version
0.0.0-insiders.e002ab824 Sept 2025pre-release
Nothing published for this version
0.0.0-insiders.dfd0d4b1 Feb 2022pre-release
Nothing published for this version
0.0.0-insiders.d1e642128 Jan 2025pre-release
Nothing published for this version
0.0.0-insiders.d0444085 Feb 2022pre-release
Nothing published for this version
0.0.0-insiders.cf1533330 Aug 2023pre-release
Nothing published for this version

@tailwindcss/typography

Release timeline

Releases

Fixed

Fixed

Fixed

Added

Fixed

Changed

Fixed

Fixed

Fixed

Fixed

Added

Added

Fixed

Fixed

Fixed

Fixed

Fixed

Fixed

Added

Fixed

Added

Fixed

Fixed

Removed

Fixed

Added

Changes

Changes

Changes

Fixed

Fixed

Fixed

Added

Changed (internal)

Fixed

Added

Changed (internal)

Changed

Added

Upgrading from v0.2.0 to v0.3.0

Customizations should be moved under extend, default should become DEFAULT

Colors are read from theme by default

Changes

Fixes

Fixes

Fixes

Fixes

Added