[View on GitHub](https://github.com/tailwindlabs/tailwindcss-typography)!
Beautiful typographic defaults for HTML you don't control.
The official Tailwind CSS Typography plugin provides a set of prose classes you can use to add beautiful typographic defaults to any vanilla HTML you don’t control, like HTML rendered from Markdown, or pulled from a CMS.
Tailwind CSS IntelliSense extension for Visual Studio Code
```
<articleclass="prose lg:prose-xl">
{{ markdown }}
</article>
```
To see what it looks like in action, check out our [live demo](https://play.tailwindcss.com/uj1vGACRJA?layout=preview) on Tailwind Play.
## Installation
### Install the plugin from npm:
```
npm install -D @tailwindcss/typography
```
Then add the plugin to your tailwind.config.js file: tailwind.config.js
```
module.exports = {
theme: {
// ...
},
plugins: [
require('@tailwindcss/typography'),
// ...
],
}
```
## Basic usage
Now you can use the prose classes to add sensible typography styles to any vanilla HTML:
```
<articleclass="prose lg:prose-xl">
<h1>Garlic bread with cheese: What the science tells us</h1>
<p>
For years parents have espoused the health benefits of eating garlic bread with cheese to their
children, with the food earning such an iconic status in our culture that kids will often dress
up as warm, cheesy loaf for Halloween.
</p>
<p>
But a recent study shows that the celebrated appetizer may be linked to a series of rabies cases
springing up around the country.
</p>
</article>
```
## Choosing a gray scale
This plugin includes a modifier class for each of the five gray scales Tailwind includes by default so you can easily style your content to match the grays you’re using in your project.
```
<articleclass="prose prose-slate">
{{ markdown }}
</article>
```
## Here are the classes that are generated using a totally default Tailwind CSS v2.0 build:
| Class | Gray scale |
| ----------- | ----------- |
| prose-gray (default) | Gray |
| prose-slate | Slate |
| prose-zinc | Zinc |
| prose-neutral | Neutral |
| prose-stone | Stone |
Modifier classes are designed to be used with the multi-class modifier pattern and must be used in conjunction with the base prose class.
Always include the `prose` class when adding a gray scale modifier
```
<articleclass="prose prose-stone">
{{ markdown }}
</article>
```
To learn about creating your own color themes, read the adding custom color themes documentation.
## Applying a type scale
Size modifiers allow you to adjust the overall size of your typography for different contexts.
```
<articleclass="prose prose-xl">
{{ markdown }}
</article>
```
### Five different typography sizes are included out of the box:
Class Body font size
| prose-sm | Gray scale |
| ----------- | ----------- |
| prose-gray (default) | 0.875rem (14px) |
| prose-base (default) | 1rem (16px) |
| prose-lg | 1.125rem (18px) |
| prose-xl | 1.25rem (20px) |
| prose-2xl | 1.5rem (24px) |
These can be used in combination with Tailwind’s breakpoint modifiers to change the overall font size of a piece of content at different viewport sizes:
```
<articleclass="prose md:prose-lg lg:prose-xl">
{{ markdown }}
</article>
```
Everything about the provided size modifiers has been hand-tuned by professional designers to look as beautiful as possible, including the relationships between font sizes, heading spacing, code block padding, and more.
Size modifiers are designed to be used with the multi-class modifier pattern and must be used in conjunction with the base prose class.
Always include the `prose` class when adding a size modifier
```
<articleclass="prose prose-lg">
{{ markdown }}
</article>
```
To learn about customizing the included type scales, read the documentation on customizing the CSS.
## Adapting to dark mode
Each default color theme includes a hand-designed dark mode version that you can trigger by adding the prose-invert class:
```
<articleclass="prose dark:prose-invert">
{{ markdown }}
</article>
```
To learn about creating your own color themes, read the adding custom color themes documentation.
Element modifiers
Use element modifiers to customize the style of individual elements in your content directly in your HTML:
## Read the Tailwind CSS documentation on ordering stacked modifiers to learn more.
Overriding max-width
Each size modifier comes with a baked in max-width designed to keep the content as readable as possible. This isn’t always what you want though, and sometimes you’ll want the content to just fill the width of its container.
In those cases, all you need to do is add max-w-none to your content to override the embedded max-width:
```
<divclass="grid grid-cols-4">
<divclass="col-span-1">
<!-- ... -->
</div>
<divclass="col-span-3">
<articleclass="prose max-w-none">
{{ markdown }}
</article>
</div>
</div>
```
## Advanced topics
Undoing typography styles
If you have a block of markup embedded in some content that shouldn’t inherit the prose styles, use the not-prose class to sandbox it:
```
<articleclass="prose">
<h1>My Heading</h1>
<p>...</p>
<divclass="not-prose">
<!-- Some example or demo that needs to be prose-free -->
</div>
<p>...</p>
<!-- ... -->
</article>
```
Note that you can’t nest new prose instances within a not-prose block at this time.
## Adding custom color themes
You can create your own color theme by adding a new key in the typography section of your tailwind.config.js file and providing your colors under the css key:
<!-- Some example or demo that needs to be prose-free -->
</div>
<p>...</p>
<!-- ... -->
</article>
```
## Customizing the CSS
If you want to customize the raw CSS generated by this plugin, add your overrides under the typography key in the theme section of your tailwind.config.js file:
```
tailwind.config.js
module.exports = {
theme: {
extend: {
typography: {
DEFAULT: {
css: {
color: '#333',
a: {
color: '#3182ce',
'&:hover': {
color: '#2c5282',
},
},
},
},
},
},
},
plugins: [
require('@tailwindcss/typography'),
// ...
],
}
```
Like with all theme customizations in Tailwind, you can also define the typography key as a function if you need access to the theme helper:
```
tailwind.config.js
module.exports = {
theme: {
extend: {
typography: (theme) => ({
DEFAULT: {
css: {
color: theme('colors.gray.800'),
// ...
},
},
}),
},
},
plugins: [
require('@tailwindcss/typography'),
// ...
],
}
```
Customizations should be applied to a specific modifier like DEFAULT or xl, and must be added under the css property. Customizations are authored in the same CSS-in-JS syntax used to write Tailwind plugins.
See the default styles for this plugin for more in-depth examples of configuring each modifier.
