Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–226 runs
build_error
glibcnode 18–226 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
default
✓ import prettierPluginMerge from 'prettier-plugin-merge'
✗ const prettierPluginMerge = require('prettier-plugin-merge')
ESM-only since v0.8.0. CommonJS require will fail.
plugins config
✓ {
"plugins": [
"prettier-plugin-tailwindcss",
"prettier-plugin-classnames",
"prettier-plugin-merge"
]
}
✗ {
"plugins": [
"prettier-plugin-merge",
"prettier-plugin-tailwindcss"
]
}
The merge plugin MUST be listed last in the plugins array.
overrides
✓ {
"overrides": [
{
"files": ["*.md", "*.mdx"],
"options": {
"plugins": []
}
}
]
}
To prevent unintended formatting inside Markdown/MDX code blocks, you can override to clear plugins for those files.
Shows installation, config file setup, and programmatic usage with multiple plugins merged via prettier-plugin-merge.
// Install: npm install -D prettier prettier-plugin-merge prettier-plugin-tailwindcss prettier-plugin-classnames
// In .prettierrc (JSON)
{
"plugins": [
"prettier-plugin-tailwindcss",
"prettier-plugin-classnames",
"prettier-plugin-merge"
]
}
// Or programmatically (ESM)
import prettier from 'prettier';
const code = `
<div class="mt-2 p-4 bg-white text-black">
Hello
</div>
`;
const formatted = await prettier.format(code, {
parser: 'html',
plugins: [
'prettier-plugin-tailwindcss',
'prettier-plugin-classnames',
'prettier-plugin-merge'
]
});
console.log(formatted);
// Expected output: Tailwind classes sorted, class names sorted/merged.
Errors
Common errors & fixes
Error: Cannot find module 'prettier-plugin-merge'
Missing installation or not in node_modules.
fixRun npm install -D prettier-plugin-merge
Error: Cannot use import statement outside a module
Using ESM import in CommonJS project.
fixAdd "type": "module" to package.json or use require (if your version supports CJS, but v0.8+ is ESM-only).
Error: [prettier-plugin-merge] The plugin must be the last in the 'plugins' array.
Plugin not listed last in configuration.
fixMove 'prettier-plugin-merge' to the end of the plugins array in .prettierrc or config.
Audit
Dependencies
prettierrequiredPeer dependency: plugin requires Prettier v3 to function.