MarkdownViewer++ 的 CSS 主题路径由插件设置中“Use custom CSS file”指定的绝对路径决定，优先加载该路径文件，未设置则回退内置 default.css；需UTF-8无BOM编码，修改后须重启预览面板生效。
MarkdownViewer++ 的 CSS 主题路径在哪
主题样式不是通过 Notepad++ 自带的“样式配置器”改的，而是由 MarkdownViewerPlusPlus.dll 加载外部 CSS 文件控制。默认主题文件叫 default.css，它被硬编码在插件资源里，但你**可以覆盖它**——只要在插件配置里指定自定义 CSS 路径。
实际生效的 CSS 文件位置取决于你的配置：插件会优先读取你手动设置的路径；没设就 fallback 到内置默认；设了但路径无效则渲染失败（预览区空白或报错）。
- 推荐做法：新建一个
my-theme.css放在容易访问的位置，比如C:\Users\YourName\Documents\md-themes\ - 路径必须是**绝对路径**，不能用相对路径或环境变量（如
%APPDATA%） - 文件编码需为 UTF-8 无 BOM，否则中文注释或字符可能乱码
如何在插件设置中启用自定义 CSS
打开 Notepad++ → 插件 → MarkdownViewer++ → Settings...，切换到 “Appearance” 选项卡：
- 勾选
Use custom CSS file - 在
Custom CSS file path输入框粘贴你的 CSS 文件绝对路径，例如：C:\Users\YourName\Documents\md-themes\dark-mode.css - 点击
Save，然后关闭设置窗口 - **必须重启预览面板**：先关掉当前预览（快捷键
Ctrl+Shift+M再按一次），再重新开启才能加载新 CSS
注意：修改 CSS 后无需重启 Notepad++，但每次改完 CSS 文件内容，都要手动刷新预览（关再开，或保存 Markdown 文件触发重渲染）。
写一个可用的 dark-mode.css 示例
直接复制下面内容保存为 dark-mode.css，就能获得基础暗色主题。关键点是重置 body 背景和文字颜色，并确保代码块、表格等元素适配：
body {
background-color: #1e1e1e;
color: #e0e0e0;
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
}
h1, h2, h3, h4, h5, h6 {
color: #ffffff;
}
code, pre {
background-color: #2d2d2d;
color: #f8f8f2;
}
pre code {
background: none;
}
blockquote {
border-left: 4px solid #4a90e2;
color: #a0a0a0;
}
别漏掉 pre code 这行：否则代码块内嵌高亮会继承外层背景，导致文字看不清。这是最容易踩的样式坑。
为什么改了 CSS 没反应？常见失效原因
不是所有 CSS 都能生效，因为 MarkdownViewer++ 渲染的是 HTML 片段，不是完整页面，且部分标签被包裹在特定 class 容器里（如 .markdown-body）。以下情况会导致样式“看起来没变”：
- CSS 选择器权重不够：用
.markdown-body h2比单纯h2更可靠 - 用了不支持的 CSS 属性：比如
backdrop-filter在旧版 WebKit 内核（插件所用）中不支持 - 路径含中文或空格但没加引号：Windows 路径本身不需要引号，但若路径含特殊字符，建议改用英文目录名
- Notepad++ 是 32 位版本，而你放的 CSS 路径在 OneDrive 或某些云同步目录下，可能因权限或符号链接导致读取失败
最稳妥的调试方式：先用最简 CSS（只改 body { background:red; }）验证路径和加载是否成功，再逐步叠加样式。主题切换的本质是路径控制 + CSS 作用域理解，而不是“换皮肤”式的黑盒操作。
