# stylelint-config-html
> The shareable HTML config for Stylelint.
Latest version **2.0.0** (published 2026-08-01) · MIT license · 0 weekly downloads
## Install
```sh
npm install stylelint-config-html
pnpm add stylelint-config-html
yarn add stylelint-config-html
bun add stylelint-config-html
```
## Health
**Score 65/100 (B)** — status: active.
Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.
Warnings: low downloads; no types.
## Facts
| | |
|---|---|
| Version | 2.0.0 |
| Published | 2026-08-01 |
| First published | 2021-10-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | ^22.12 \|\| >=24 |
| Dependencies | 0 |
| Unpacked size | 10.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 89 |
| Author | Yosuke Ota |
| Maintainers | ota-meshi |
| Keywords | stylelint, stylelint-config, html, vue, svelte, php, xml |
## Links
- npm: https://www.npmjs.com/package/stylelint-config-html
- Repository: https://github.com/ota-meshi/stylelint-config-html
- Homepage: https://github.com/ota-meshi/stylelint-config-html#readme
- Issues: https://github.com/ota-meshi/stylelint-config-html/issues
- Funding: https://github.com/sponsors/ota-meshi
- npm.io page: https://npm.io/package/stylelint-config-html
## Alternatives
- [babylon](https://npm.io/package/babylon.md) — 5.1M weekly downloads
- [csscolorparser](https://npm.io/package/csscolorparser.md) — 3.7M weekly downloads
- [expr-eval-fork](https://npm.io/package/expr-eval-fork.md) — 1.5M weekly downloads
- [@leeoniya/ufuzzy](https://npm.io/package/@leeoniya/ufuzzy.md) — 247.7K weekly downloads
- [xml-parser](https://npm.io/package/xml-parser.md) — 78.4K weekly downloads
## Recent versions
- 2.0.0 (latest) — 2026-08-01
- 1.1.0 — 2022-07-07
- 1.0.0 — 2021-10-22
- 0.0.2 — 2021-10-20
- 0.0.1 — 2021-10-19
## README
# stylelint-config-html
[](https://www.npmjs.com/package/stylelint-config-html)
[](https://www.npmjs.com/package/stylelint-config-html)
[](http://www.npmtrends.com/stylelint-config-html)
[](http://www.npmtrends.com/stylelint-config-html)
[](https://github.com/ota-meshi/stylelint-config-html/actions?query=workflow%3ACI)
> The shareable HTML (and HTML-like) config for [Stylelint].
This config bundles the [`postcss-html` custom syntax](https://github.com/ota-meshi/postcss-html) and configures it.
If you use this config in your Stylelint config, HTML, XML, [Vue], [Svelte], [Astro], and [PHP] files will be parsable. The Stylelint rules you have configured will be able to check these files.
> **Requirements**
>
> - [Stylelint] v16.0.0 and above
> - [postcss-html](https://github.com/ota-meshi/postcss-html) v2.0.0 and above
> - Node.js `^22.12 || >=24`
Stylelint v14 and above has been changed to not bundle non-CSS parsing such as HTML. The goal of this config is to make Stylelint work with HTML (and HTML-like) files, like Stylelint v13.
To see this config, please read the [config itself](/index.js).
## :couple: Related Packages
### [stylelint-config-recommended-vue](https://github.com/ota-meshi/stylelint-config-recommended-vue) / [stylelint-config-standard-vue](https://github.com/ota-meshi/stylelint-config-standard-vue)
The shareable config for [Vue](https://v3.vuejs.org/).
If you want to check [Vue] files, consider using this as well. It is useful because it contains the config for [Vue](https://v3.vuejs.org/).
### [postcss-html](https://github.com/ota-meshi/postcss-html)
[PostCSS] syntax for parsing HTML (and HTML-like).
If you have problems with parses using this config, please open the new issue in that repository.
## :cd: Installation
```shell
npm install --save-dev postcss-html stylelint-config-html
```
## :book: Usage
Set your `stylelint` config to:
```json
{
"extends": "stylelint-config-html"
}
```
Note: This config enables HTML (and HTML-like) syntax parsing.
If you want to enable parsing for only specific language, use each language config as follows:
```json
{
"extends": [
"stylelint-config-html/html",
"stylelint-config-html/xml",
"stylelint-config-html/vue",
"stylelint-config-html/svelte",
"stylelint-config-html/astro",
"stylelint-config-html/php"
]
}
```
## :computer: Editor integrations
### Visual Studio Code
Use the [stylelint.vscode-stylelint](https://marketplace.visualstudio.com/items?itemName=stylelint.vscode-stylelint) extension that [Stylelint] provides officially.
You have to configure the `stylelint.validate` option of the extension to check `.html`, `.vue`, `.svelte`, `.astro`, and HTML-like files, because the extension does not check the `*.html` and HTML-like file by default.
Example **.vscode/settings.json**:
```jsonc
{
"stylelint.validate": [
...,
// ↓ Add "html" language.
"html",
// ↓ Add "vue" language.
"vue",
// ↓ Add "svelte" language.
"svelte",
// ↓ Add "astro" language.
"astro",
]
```
## :lock: License
See the [LICENSE](LICENSE) file for license rights and limitations (MIT).
[Stylelint]: https://stylelint.io/
[Vue]: https://v3.vuejs.org/guide/single-file-component.html
[Svelte]: https://svelte.dev/docs#Component_format
[Astro]: https://docs.astro.build/core-concepts/astro-components/
[PHP]: https://www.php.net/manual/en/intro-whatis.php
[PostCss]: https://github.com/postcss/postcss
---
_Source: https://npm.io/package/stylelint-config-html · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._