VSCode怎么写Markdown文档_VSCode Markdown预览编辑教程【实用】-VSCode-PHP中文网

vscode markdown 基础配置需三步：一设语言模式为 markdown 并保存为 .md 文件；二配 imageuploader 存图至 assets/ 并用相对路径；三装 markdown-pdf 扩展并指定中文字体导出 pdf。

vscode怎么写markdown文档_vscode markdown预览编辑教程【实用】

VSCode 写 Markdown 不用装一堆插件也能跑起来，但默认配置下预览打不开、图片粘贴失败、导出 PDF 中文乱码——这些问题不是你操作错，而是几个关键开关没拨对。

预览快捷键没反应？先确认语言模式和文件后缀

按 Ctrl+Shift+V 没反应，90% 是 VSCode 根本没把当前文件当 Markdown 处理。它只认 .md 或 .markdown 后缀，且依赖语言模式激活语法支持。

检查右下角状态栏：必须显示 Markdown，不是 Plain Text 或空白
手动设置语言模式：Ctrl+K M → 输入 markdown → 回车
临时文件（比如粘贴内容新建的无名文件）不会自动识别，务必先保存为 xxx.md
如果用了远程开发（SSH/WSL），确保远程端也加载了 Markdown 语言支持（通常默认已启用）

图片粘贴进不去 assets 文件夹？改这两项配置

直接 Ctrl+V 粘贴截图，默认会失败或生成绝对路径，跨设备就炸。真正可用的方案是让 VSCode 自动存图并写相对路径。

VSCode 1.118

微软正式发布 Visual Studio Code 1.118 版本。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控。

下载

在 settings.json 中添加：

"markdown.extension.imageUploader.action": "copy",
"markdown.extension.imageUploader.uploadMethod": "none"

确保工作区根目录下存在 assets/ 文件夹（不存在就手动建一个）
不要用资源管理器拖拽图片——它硬编码本地绝对路径，file:/// 开头的链接在别人电脑上肯定 404
粘贴后若报 Unable to write file: Permission denied，说明 assets/ 权限不对或路径不存在，不是插件问题

导出 PDF 中文变方框？别用浏览器打印

右键预览页 → “Print” → 保存为 PDF，中文基本全成口口口。VSCode 原生预览走的是简易 HTML 渲染链，不带中文字体嵌入能力。

装 markdown-pdf 扩展（注意不是同名旧版），它用 Puppeteer 引擎，能指定系统字体

导出前，在 settings.json 加上：

"markdown-pdf.displayHeaderFooter": true,
"markdown-pdf.fontFamily": "'Noto Sans CJK SC', 'Microsoft YaHei', sans-serif"

命令面板调用：Ctrl+Shift+P → 输入 Markdown PDF: Export (pdf)
如果仍乱码，检查系统是否安装了对应中文字体（如 Noto Sans CJK SC 是 Google 开源字体，macOS 和 Linux 需手动安装）

数学公式和 Mermaid 图表不渲染？别混用预览扩展

$$E = mc^2$$ 或 mermaid 代码块不显示，常见原因是多个预览扩展冲突，或者 MathJax 渲染被禁用。

禁用 VSCode 原生预览："markdown.preview.enabled": false（否则和 Markdown All in One 或 Markdown Preview Enhanced 抢控件）
只留一个主力预览扩展：推荐 Markdown All in One + 开启 "markdown.extension.math.enabled": true
Mermaid 需额外配置：Markdown Preview Enhanced 支持更全，但启动慢；Markdown All in One 仅支持基础流程图，且需在设置中打开 "markdown.extension.mermaid.enabled": true
公式必须独占一行才能被识别为块级公式， $E=mc^2$ 这种行内写法要配合 KaTeX 支持，不是所有扩展都默认开启

最常被跳过的其实是工作区级别的 settings.json 配置——用户级设置在多项目间不通用，而每个文档的渲染效果，往往取决于它所在文件夹有没有正确配好 markdown.styles、markdown.extension.imageUploader 这几项。配一次，之后开新文档就不踩坑。