tailwindlabs/tailwindcss-typography
Tailwindcss Typography
Tailwind CSS Typography is a plugin for the Tailwind CSS framework that provides hand-tuned typographic defaults for blocks of vanilla HTML content, such as content from Markdown or a CMS. It applies beautiful prose styles to HTML content using a single class, eliminating the need for custom CSS to style rich text.
The plugin distinguishes itself by offering deep customization and control over typography. Users can adjust the overall font size of prose content across five predefined sizes, select from five built-in gray-scale palettes to match a project's color scheme, and seamlessly adapt typography for dark mode by adding a single modifier class. It also allows for the creation of custom color themes using CSS custom properties, and provides the ability to override generated CSS with a JavaScript-based theme API. For fine-grained control, individual HTML elements within prose can be targeted with modifier classes, and blocks of content can be excluded from prose style inheritance using a sandbox class.
Beyond its core typography features, the plugin integrates with Tailwind's broader utility-first system, enabling responsive breakpoint styling, conditional variants for states like hover and focus, and support for user accessibility preferences such as reduced motion. It also offers capabilities for styling elements based on container size, applying styles for print, and handling directional layouts.
Features
- Prose Typography Styling - Applies hand-tuned typographic defaults to vanilla HTML content from Markdown or a CMS.
- Prose Typography Utilities - Provides default typographic styles for Markdown and CMS content using a single prose class.
- CSS Value Injections - Creates one-off utility classes by allowing arbitrary CSS values directly in square bracket syntax within HTML.
- Plugin Configurations - Accepts a configuration object from users to customize plugin behavior like class names.
- Color Themes - Defines custom color themes by providing colors in a configuration file.
- Custom Color Theme Definitions - Creates new color themes by declaring CSS custom properties or configuring a theme object.
- Prose - Enables defining custom color themes for prose content via CSS custom properties or configuration.
- Tailwind CSS Integration - Extends the Tailwind CSS framework with custom base styles, component classes, and utility variants.
- Prose Typography Plugins - Adds hand-tuned prose classes to vanilla HTML content for beautiful typography without custom CSS.
- Dark Mode Support - Switches prose content to a dark color theme by adding a single modifier class.
- HTML Content Processing - Applies typographic defaults to blocks of vanilla HTML like content from Markdown or a CMS.
- Dark Mode Strategies - Switches to a dark color theme by adding a single modifier class.
- Prose Dark Mode Modifiers - Toggles a dark color scheme on prose content by adding a single modifier class.
- Typography Dark Mode Adaptation - Switches to a dark-mode color theme by adding a single modifier class.
- Theme Definitions - Defines color themes and typography scales using CSS custom properties for runtime customization.
- Styling Variants - Applies styles conditionally by prefixing utility classes with variant modifiers for states, breakpoints, and preferences.
- Prose Styling Plugins - Provides a plugin that applies typographic defaults to HTML content with dark mode and custom themes.
- Utility-First Styling - Builds styles by composing single-purpose utility classes directly in HTML markup.
- Plugin-Based Base Styles - Adds global base styles like typography defaults and font-face rules to the CSS output.
- Prose Size and Gray Scale Selection - Adjusts prose font size across five predefined sizes and selects from built-in gray-scale palettes.
- CSS Build Plugins - Generates CSS by merging user-provided JavaScript configuration objects with default theme values at build time.
- CSS-in-JS Authoring Tools - Defines styles using CSS-in-JS syntax with camelCase properties and nesting support.
- Utility-First CSS Frameworks - Extends a utility-first CSS framework with reusable typography defaults and color themes.
- JavaScript-Based CSS Overrides - Overrides generated CSS using a JavaScript-based theme API with CSS-in-JS syntax.
- HTML Element Transformers - Targets specific HTML elements with utility modifiers for fine-grained control.
- Custom Variant Registrations - Defines a reusable custom variant using a directive for repeated use across a project.
- Named Container Queries - Styles elements based on the size of a specific named container among multiple nested containers.
- Primitive Element Styling - Targets specific HTML elements like headings and links to apply custom utility styles.
- Plugin-Based Component Classes - Adds pre-built component styles like buttons and form controls to the CSS output.
- Plugin-Based Utility Classes - Adds new static or dynamic utility styles to the CSS output with support for theme values.
- Custom Breakpoints - Overrides default breakpoint values by defining custom theme variables for responsive design.
- Container Queries - Styles child elements based on a parent container's inline size using container query variants.
- Container Query Length Units - References container dimensions with units like cqw and cqi in arbitrary values.
- Container Query Ranges - Combines min-width and max-width container variants to apply styles within a size range.
- Container Query Styling - Styles child elements based on a parent container's inline size using container query variants.
- Named - Names a container and uses that name in container query variants for distant ancestor sizing.
- Named Container Queries - Names containers and references them in variants to style children based on distant container sizes.
- Container Query Styling - Marks an element as a container and applies styles to children at specified container widths.
- Responsive Breakpoints - Applies utility classes only when the viewport matches a specific breakpoint using variants.
- Content Sandboxing - Prevents style inheritance by wrapping content in a class that scopes typography styles to specific containers.
- Arbitrary Selector Variants - Creates utility classes from custom CSS selectors defined directly in HTML using arbitrary variants in square brackets.
- Reusable Variant Definitions - Defines a new custom variant using a directive for reuse across the project.
- Content-Specific Styling - Targets specific HTML elements with modifier classes to apply custom utility styles in markup.
- Prose - Allows overriding generated typography CSS via a JavaScript theme API and sandboxing content.
- ARIA Attribute Styling - Applies styles when an element has a specific ARIA state or data attribute using variants.
- Plugin-Based Variant Modifiers - Creates new modifier prefixes for conditional styles with static and parameterized variants.
- Framework Plugins - Adds typographic defaults for long-form content.
