Appearance
Tailwind 集成与样式顺序
如果你的项目使用 Tailwind 或基于 Tailwind 的组件库(如 shadcn),可能会遇到样式覆盖问题。推荐将 vue-renderer-markdown 的 CSS 导入置于 @layer components { ... } 中以控制样式优先级。
示例:
css
@tailwind base;
@tailwind components;
@tailwind utilities;
@layer components {
@import 'vue-renderer-markdown/index.css';
}更多替代方案:使用 prefix 配置以避免类名冲突,或在应用层覆盖样式。
在 Tailwind 中避免重复生成 CSS
为了在使用 Tailwind 的项目中减少重复的 utility CSS,推荐优先使用本包提供的 "tailwind-ready" 输出,而不是完整的预编译 index.css。
- Tailwind v3(推荐流程):
- 在应用中引入
index.tailwind.css,这样只会引入组件样式而不会把 Tailwind 的工具类重复打包进去。 - 在
tailwind.config.js的content中加入本包生成的类列表,使 Tailwind 能识别并避免重新生成相同的类。
- 在应用中引入
示例(Tailwind v3 / tailwind.config.js):
js
module.exports = {
content: [
'./src/**/*.{js,ts,vue}',
// 包安装后可以使用:require('vue-renderer-markdown/tailwind')
require('vue-renderer-markdown/tailwind'),
],
}示例 CSS 导入(应用入口):
css
@tailwind base;
@tailwind components;
@tailwind utilities;
@import 'vue-renderer-markdown/index.tailwind.css';Tailwind v4:可以直接包含
index.tailwind.css,使用 v4 的扫描器发现类名,无需额外的tailwind.ts辅助文件。非 Tailwind 项目:继续使用预编译好的
index.css:
css
@import 'vue-renderer-markdown/index.css';说明:
- 本包导出
./tailwind条目(./dist/tailwind.ts),导出的是提取出的 class 列表。发布到 npm 后可以在tailwind.config.js中通过require('vue-renderer-markdown/tailwind')引入该列表。 - 在本地开发时也可以直接引用生成文件(例如
./dist/tailwind.ts)。