VSCode原生Markdown预览样式无法通过settings.json完全修改，因其颜色、段落间距等由Mume渲染引擎在HTML层生成，必须通过Markdown Preview Enhanced插件注入自定义CSS（如./markdown-styles.css）并使用.mume前缀选择器（如.mume .md p）精准覆盖，同时单独配置prismTheme和katex选项以适配代码高亮与公式渲染。
VSCode 默认的 Markdown 预览界面配色单调、对比度低、代码块样式生硬，直接改 settings.json 无法覆盖全部样式节点——必须通过 Markdown Preview Enhanced 插件 + 自定义 CSS 双路径生效。
为什么原生设置改不动预览颜色？
VSCode 内置的 markdown.preview.* 配置项（如 markdown.preview.fontSize）只控制极少数基础属性，而颜色、段落间距、代码块高亮主题、标题层级样式等均由渲染引擎（Mume）在 HTML 层生成，CSS 优先级高于 JSON 设置。不注入 CSS，所有“主题色”“深色模式适配”“Typora 风格段落”都只是空谈。
-
markdown.preview.colorScheme已被弃用，设了也无效 - 修改
workbench.colorCustomizations对预览窗口完全无影响 - 仅启用
markdown-preview-enhanced.previewTheme选内置主题（如github-dark）是最低成本方案，但定制自由度极低
如何让自定义 CSS 真正生效？
关键不是“写 CSS”，而是“让插件加载它”。Markdown Preview Enhanced 提供两个明确入口点：
- 主样式：通过
markdown-preview-enhanced.styles指向一个全局 CSS 文件路径（推荐放在项目根目录或~/.vscode/下） - 代码块高亮：单独配置
markdown-preview-enhanced.prismTheme，值为本地prism.css路径，或在线 CDN URL（如https://unpkg.com/prismjs@1.29.0/themes/prism-okaidia.css） - 路径必须是绝对路径或相对于工作区根的相对路径；用
~/开头需确保 VSCode 能正确解析（macOS/Linux 更稳，Windows 建议用完整路径）
示例配置（settings.json）：
将PDF文件（含扫描件、图片）转换为Markdown格式。接入MinerU和PaddleOCR双引擎，支持扫描件OCR识别、公式表格解析、多语言识别。兼容本地OCR识别。
"markdown-preview-enhanced.styles": ["./markdown-styles.css"], "markdown-preview-enhanced.prismTheme": "./prism-dark.css"
哪些 CSS 选择器最常被漏掉？
很多人写了 CSS 却没效果，是因为没命中真实 DOM 结构。预览页由 Mume 渲染，主体内容包裹在 .mume 容器内，且大量元素带内联样式或 JS 动态 class。务必加前缀或提高权重：
- 正文段落：用
.mume .md p而非单纯p，否则被默认样式覆盖 - 代码块：
.mume pre code控制文字，.mume .highlight控制背景色块 - 标题锚点链接（TOC 生成的）：
.mume h1 > a, .mume h2 > a，不然点击跳转时下划线突兀 - 避免用
!important—— 它会让后续调试和主题切换失效，优先靠选择器精度解决
深色模式下字体发灰、代码看不清？
这不是配色问题，是 VSCode 渲染层对 subpixel 字体抗锯齿的处理缺陷，尤其在 macOS 上明显。解决方案不是调色，而是绕过：
- 禁用系统字体平滑：
"editor.fontLigatures": false（间接改善预览字体渲染） - 强制使用清晰字体栈：
body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; }，去掉模糊的Helvetica - 代码块背景别用纯黑：
.mume .highlight { background-color: #1e1e1e; }（比#000更易读） - 数学公式若模糊，检查是否启用了
markdown-preview-enhanced.mathRenderingOption为katex（比 MathJax 渲染更锐利）
真正难搞的是 Mermaid 图表和 LaTeX 公式在深色背景下的 SVG fill 颜色继承逻辑——它们不走 CSS color，得靠插件设置里的 mermaid.theme 和 katex.options 单独控制，这点很容易被忽略。
