shift + alt + f对markdown表格无反应，是因为vscode默认格式化器不处理表格对齐，仅校验语法合法性；必须安装markdown all in one插件、手动选中整表（含规范分隔行）、并确保markdown.extension.tableformatter.enabled为true。
为什么Shift + Alt + F对Markdown表格没反应
不是快捷键失效，而是 VSCode 默认格式化器压根不处理表格——它只校验语法合法性，不碰列宽、对齐或空格。表格歪了，不是“格式化失败”，是根本没被读进去。
- 必须安装
Markdown All in One（不是Markdown Preview Enhanced或其他名字相近的插件） -
markdown.extension.tableFormatter.enabled必须为true（默认开启，但若手动关过就得检查） - 格式化前要手动选中整张表：包括表头行、分隔行（如
|:---|---:|）、所有数据行；漏一行，列就错位 - 分隔行写法必须严格：
|:---|（左）、|---:|（右）、|:---:|（居中）；多空格、中文破折号、少于三个-都会导致解析失败
editor.formatOnSave 为什么对代码块无效
VSCode 的 editor.formatOnSave 默认把整个 .md 文件交给 Markdown 格式化器处理，而后者只管文档结构，把 ```python 里的内容当纯文本缩进，不会调用 Python 的 PEP8 规则重排。
Markdown Converter 1.0.0
下载
使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。
- 想格式化代码块，得先将光标置于该代码块内，再按
Ctrl + K→Ctrl + F（Windows/Linux）或Cmd + K→Cmd + F（macOS）执行“Format Selection” - 执行前务必切换语言模式：点击右下角语言标识（如“Plain Text”），选对应语言（
Python、JavaScript等） - 别依赖
editor.formatOnSave自动处理代码块——它会破坏原有缩进和语法高亮，反而更乱
PDF 导出字体丑、中英文挤在一起怎么办
这不是 VSCode 或 Markdown 插件的问题，而是 markdown-pdf（yzane 版）在 HTML → PDF 渲染阶段用了默认无衬线字体，且未启用中文排版特性。
- CSS 路径必须显式配置：
markdown-pdf.cssPath设为绝对路径，例如/home/user/css/md-pdf.css - CSS 中至少覆盖两项：
body { font-family: "Noto Sans SC", "Helvetica Neue", sans-serif; }和code { font-family: "Fira Code", "SFMono-Regular", monospace; } - 中英文混排需加
text-rendering: optimizeLegibility;和font-feature-settings: "liga";（注意不是font-feature-setti这种拼错）
多个插件共存时表格格式化突然失效
常见冲突源是 Prettier ——它会在保存时重排整个文件，删空格、统一居中，直接毁掉靠空格对齐的手动调整，也干扰 Markdown All in One 的表格识别逻辑。
- 禁用 Prettier 对 Markdown 文件的接管：在
settings.json中添加"[markdown]": { "editor.defaultFormatter": "yzane.markdown-all-in-one" } - 不要同时启用其他表格格式化插件（如
Markdown Table Formatter），命令会互相覆盖或静默失败 - 如果
Alt + Shift + F没反应，用Ctrl + Shift + P输入Markdown: Format table手动触发；失败说明插件未生效或当前语言模式不是markdown
