必须先确认预览引擎：右键出现“Open Preview to the Side”为内置预览，出现“Open Preview with Enhanced”则为MPE插件；二者CSS加载路径、格式互不兼容，混用会导致预览空白或样式失效。
确认你用的是内置预览还是 MPE 插件
VSCode 里改 Markdown 预览样式，第一步不是写 CSS，而是搞清你当前用的到底是哪个预览引擎——它们加载 CSS 的方式完全不兼容，混用必失效。
打开任意 .md 文件，右键菜单看：出现 Open Preview to the Side → 内置预览；出现 Open Preview with Enhanced 或带 Markdown Preview Enhanced 字样的选项 → MPE 插件。
- MPE 插件一旦安装，会默认接管预览行为，即使你设置了
markdown.styles，它也完全无视 - 内置预览不读
~/.mume/style.less，丢进去等于白放 - 两者共存时，别指望“同时生效”，必须二选一并按对应规则配置
内置预览：用 markdown.styles 指向项目内 CSS 文件
这是最轻量的方式，不需要额外插件，但只支持标准 CSS（不能写 Less/Sass），路径必须相对于工作区根目录。
在项目根目录创建 .vscode/settings.json，写入：
OpenClaw Skill: Obsidian Markdown to Cloudflare Pages
下载
将选定的 Obsidian 笔记发布为静态站点并部署到 Cloudflare Pages。
{
"markdown.styles": ["./styles/custom.css"]
}
-
./styles/custom.css必须真实存在，且文件名、大小写、路径层级全部匹配（Styles≠styles） - 路径错误不会报错，只会静默失败；打开开发者工具（
Help → Toggle Developer Tools），查 Console 是否有Failed to load resource404 - 常见有效覆盖点：
body（背景/字体）、h1～h6（标题间距）、code（行内代码底色）、pre > code（代码块容器）
MPE 插件：只认 ~/.mume/style.less
MPE 不读 markdown.styles，也不管 .vscode/settings.json 里写了啥。它只加载固定路径下的 style.less 文件，Windows 是 C:\Users\{user}\.mume\style.less，macOS/Linux 是 ~/.mume/style.less。
- 该目录和文件需手动创建，MPE 不会自动建
- 文件名必须是
style.less，写成custom.css或preview.css就无效 - 内容可以是纯 CSS，但推荐用 Less（支持变量、嵌套），MPE 原生解析
- 改完必须手动刷新预览（
Ctrl+R或点预览页右上角 ↻），没有热更新 - 常见翻车点：
blockquote默认背景太深，加blockquote { background-color: #f6f8fa; }即可；长代码不换行，加pre { white-space: pre-wrap; }
样式不生效？先查这三个死区
改了 CSS 却没变化，90% 是卡在这三个地方：
-
~/.mume/style.less路径对但文件编码不是 UTF-8（尤其 Windows 记事本保存容易带 BOM） - 用了
markdown.styles却装了 MPE 插件，或者反过来，把style.less放进项目根目录指望内置预览读取 - CSS 选择器权重不够，比如想改
code但被 MPE 自带的.markdown-preview code覆盖，得写成.markdown-preview code或加!important（慎用）
真正麻烦的不是写样式，而是路径、插件、格式这三者之间的精确咬合——漏掉一个字母、多一层目录、或插件状态没理清，就全白干。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
