Shift + Alt + F 仅格式化 Markdown 基础结构，不处理表格对齐、代码块美化及 PDF 排版；表格需用 Markdown All in One 插件手动选中并严格分隔行格式；代码块须切换语言模式后格式化；PDF 美化依赖自定义 CSS 注入。

Shift + Alt + F（Windows/Linux）或 Shift + Option + F（macOS）能直接格式化整个 Markdown 文档——但这不等于“排版一键搞定”，它只做基础结构对齐（如标题缩进、列表符号统一），不会调整字体、行距、页眉页脚或中英文混排效果。真正影响 PDF 输出质量的，是后续的 CSS 样式定制和表格/代码块的单独处理。

为什么Shift + Alt + F对表格没反应？

VSCode 默认的 Markdown 格式化器（如内置的或 Prettier）**完全忽略表格对齐逻辑**。它只管语法合法，不管视觉是否整齐。你看到的“歪表格”，根本不是格式化失败，而是压根没被处理。

• 必须装 Markdown All in One 插件（不是 Markdown Preview Enhanced 或其他名字相近的）
• 格式化前要手动选中整张表：包括表头行、分隔行（|:---|---:|）、所有数据行——漏一行，列就错位
• 分隔行写法必须严格：|:---|（左）、|---:|（右）、|:---:|（居中），多空格、少破折号、用中文符号都会失效
• 快捷键 Alt + Shift + F 是插件绑定的“Format table”命令，不是全局格式化；若无效，用 Ctrl + Shift + P 输入 Markdown: Format table 手动触发

如何让代码块里的 Python/JS 也自动美化？

默认的 Format Document 只走 Markdown 解析流程，代码块内容会被原样保留。想让 ```python 里的代码也按 PEP8 或 ESLint 规则重排，得临时切换语言模式。

pdf文档转markdown

将PDF文件（含扫描件、图片）转换为Markdown格式。接入MinerU和PaddleOCR双引擎，支持扫描件OCR识别、公式表格解析、多语言识别。兼容本地OCR识别。

下载

• 选中代码块内全部内容（不包括 ```python 和 ``` 行）
• 点右下角语言模式 → 改成 Python 或 JavaScript
• 按 Ctrl + K Ctrl + F（Windows/Linux）或 Cmd + K Cmd + F（macOS）执行“Format Selection”
• 完事后切回 Markdown 模式，避免误格式化文档其他部分
• 别依赖 editor.formatOnSave 自动处理代码块——它会把整个 .md 文件扔给 Markdown 格式化器，结果就是代码块被当普通文本缩进，反而更乱

PDF 导出后字体丑、中英文挤在一起？

这不是 VSCode 的问题，而是 Markdown PDF 插件（yzane 版）在 HTML → PDF 渲染阶段，用了默认的无衬线字体族，且未适配中文排版特性。解决路径只有一条：**写自定义 CSS 并指定给插件加载**。

• CSS 文件路径需在 VSCode 设置里显式配置：markdown-pdf.cssPath，值为绝对路径（如 /home/user/css/md-pdf.css）
• 关键样式必须覆盖：body 的 font-family（推荐 "Noto Sans SC", "Helvetica Neue", sans-serif）、code 块的 font-family（用等宽字体如 "Fira Code", "SFMono-Regular"）
• 中英文混排要加 text-rendering: optimizeLegibility 和 font-feature-settings: "liga"，否则连字符、数字宽度会异常
• 别试图用 editor.fontFamily 设置影响 PDF 输出——那是编辑器界面字体，和导出无关

真正卡住人的地方，从来不是“怎么按快捷键”，而是搞不清哪个环节该用哪套规则：表格靠插件选中处理，代码块靠手动切语言，PDF 排版靠外部 CSS 注入——三者互不感知，各自生效。漏掉任意一环，文档看起来就永远差一口气。