[特殊字符] VS Code + Markdown 从入门到精通：写论文、技术文档的超实用指南

告别 Word 排版焦虑，拥抱纯文本的高效写作

前言

作为一个经常写技术文档和课程论文的电气工程狗，我曾经也被 Word 的"玄学排版"折磨得死去活来------目录对不齐、标题样式乱跳、参考文献编号全靠手打、公式一多就卡死......直到我遇到了 VS Code + Markdown + Pandoc 这套组合拳，彻底解放了生产力。

今天，我就把压箱底的技巧全盘托出，从零开始教你如何用 VS Code 优雅地写 Markdown，并导出为标准 Word 文档。内容涵盖实时预览、快捷键、插件配置、Pandoc 转换、论文排版（分栏、首行缩进、表格跨栏）、参考文献引用等所有你问过的问题。

一、为什么选择 VS Code + Markdown？

对比项	Word	VS Code + Markdown
排版	所见即所得，但样式容易乱	内容与样式分离，导出统一
版本控制	二进制文件，难以 diff	纯文本，Git 完美支持
公式	插入慢，渲染卡	LaTeX 语法，实时渲染
代码块	需要插件，格式易乱	原生支持，高亮美观
跨平台	收费/兼容性问题	免费，全平台一致

用 Markdown 写作，你只需要专注于内容，剩下的交给工具。

二、环境搭建：5 分钟配置好写作神器

2.1 安装 VS Code

去 code.visualstudio.com 下载安装，一路 Next 即可。

2.2 安装必备插件

打开 VS Code，按下 Ctrl + Shift + X 打开扩展商店，搜索并安装以下插件：

插件名称	作用	作者
Markdown All in One	目录生成、快捷键、自动补全	Yu Zhang
Markdown Preview Enhanced	超强预览（支持流程图、LaTeX、导出）	Yiyi Wang

安装后记得重启 VS Code。

2.3 第一个 Markdown 文件

新建一个文件，保存为 test.md，输入以下内容：

markdown 复制代码

# 一级标题

## 二级标题

这是**加粗**文本，这是*斜体*。

- 列表项1
- 列表项2

[链接文字](https://www.example.com)

![图片描述](图片路径)

按下 Ctrl + K V，你会看到右侧实时预览窗口(或者在右上角直接打开分栏图标)。恭喜你，已经入门了！

三、核心技巧：你问我答

下面是我根据读者提问整理的高频问题，每一个都是干货。

Q1：如何实现"左边 Markdown，右边 Word 风格预览"？

答：按下 Ctrl + K V 即可左右分屏实时预览。如果你觉得预览样式太"代码风"，可以安装 Markdown Preview Enhanced 插件，然后在设置中搜索 Preview Theme，切换成 github 或 atom-dark 等主题。

如果你想要更接近 Word 的纸张感，可以在插件设置中添加自定义 CSS（见下文 Q4）。

Q2：怎么打开 VS Code 的插件面板？

答：三种方式任选：

快捷键：Ctrl + Shift + X
点击左侧活动栏最下方的方块图标
菜单栏：查看 → 扩展

搜索插件名，点击"安装"即可。

Q3：Markdown 里怎么缩进（首行缩进/整体缩进）？

答：标准 Markdown 直接敲空格或 Tab 会被忽略。推荐以下方法：

首行缩进 ：在段落开头输入 &emsp;&emsp;（两个全角空格）
整体缩进 ：使用引用块 > 或无序列表 -
代码块缩进：用三个反引号包裹，内部空格会保留

如果你想要导出 Word 时自动首行缩进，可以在 CSS 中设置（见 Q4）。

Q4：如何更改预览字体/字号，并给每段加首行缩进？

答：打开 Markdown Preview Enhanced 的自定义 CSS 功能：

按 Ctrl + Shift + P 打开命令面板
输入 Customize CSS，选择 Markdown Preview Enhanced: Customize Css
在打开的 style.less 文件中添加：

css 复制代码

/* 整体字体 */
.markdown-preview.markdown-preview {
  font-family: '微软雅黑', 'Segoe UI', 'Consolas';
  font-size: 16px;
}

/* 段落首行缩进2字符 */
.markdown-preview p {
  text-indent: 2em;
  margin: 0 0 0.6em 0;
}

/* 表格跨栏（用于分栏布局） */
.markdown-preview table {
  column-span: all;
  width: 100%;
}

保存后预览自动刷新。

Q5：怎么把 Markdown 导出成 Word 文档？

答：核心工具是 Pandoc（文档转换瑞士军刀）。步骤如下：

安装 Pandoc ：去 pandoc.org 下载安装
验证安装 ：打开终端输入 pandoc --version
配置 VS Code ：安装 Markdown Preview Enhanced 插件后，打开设置（Ctrl + ,），搜索 pandocPath，填入 Pandoc 的安装路径：
- Windows：C:\Program Files\Pandoc\pandoc.exe
- macOS：/opt/homebrew/bin/pandoc
- Linux：/usr/bin/pandoc
一键导出 ：打开 .md 文件，按 Ctrl + K V 预览，在预览区右键 → Pandoc → Pandoc，即可生成同名的 .docx 文件。

常见错误 ：如果提示 Error: Output format needs to be specified，是因为 Pandoc 不知道你要导出什么格式。解决方法是在 .md 文件最开头加上 YAML Front Matter：

yaml 复制代码

---
title: "我的文档"
author: "你的名字"
output: word_document
---

Q6：Pandoc 怎么关联到 VS Code 并自动生成 Word？

答：除了上面说的 MPE 插件右键导出，还可以创建 VS Code 任务（Task）实现半自动化：

在项目根目录下创建 .vscode/tasks.json
粘贴以下内容：

json 复制代码

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "导出为 Word",
            "type": "shell",
            "command": "pandoc",
            "args": [
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}.docx"
            ],
            "group": "build"
        }
    ]
}

按 Ctrl + Shift + P，输入 Tasks: Run Task，选择"导出为 Word"即可。

Q7：如何让导出后的 Word 自动分栏（像期刊论文那样）？

答：Word 本身不支持 CSS 的 column-count，所以需要手动或模板法。

方法一（手动，最快）：导出 Word 后，选中正文（从引言到结语），点击"布局" → "分栏" → "两栏"。几秒钟搞定。

方法二（模板法，一劳永逸）：

新建一个 Word 文档，设置好分栏、页边距、字体等
另存为 template.docx
在你的 .md 文件 YAML 头中添加：

yaml 复制代码

output:
  word_document:
    reference_docx: template.docx

以后每次导出都会自动应用模板样式。

Q8：遇到宽表格，怎么让它跨栏（占满整页宽度）？

答：在导出的 Word 中手动设置：右键表格 → "表格属性" → "文字环绕"选择"无"，然后拖动表格宽度至全页宽。

如果你用 CSS 预览，可以在 style.less 中添加：

css 复制代码

.markdown-preview table {
  column-span: all;
  width: 100%;
  overflow-x: auto;
}

这样在浏览器预览中表格就会跨栏。

Q9：怎么在正文中正确引用参考文献？

答：学术论文要求正文中必须用 [编号] 标注引用来源，且编号与文末参考文献列表一一对应。

示例：

markdown 复制代码

工业以太网在实时性方面有显著优势[3]。文献[5]详细综述了确定性网络技术。

然后在文末列出：

markdown 复制代码

## 参考文献

[1] 程伟, 王鹏, 刘洋. SRv6技术在5G承载网中的应用[J]. 电信科学, 2023.
[2] 孙志刚, 李强. 面向6G的光电融合承载网络[J]. 光通信研究, 2024.
...

小技巧 ：使用 Pandoc 结合 BibTeX 可以自动管理引用，但初学阶段手动加编号也完全够用。

四、避坑指南 & 效率技巧

常见问题	解决方法
`Ctrl + +` 页面放大了？	这是浏览器/VS Code 的缩放快捷键，和我们的快捷键不冲突
导出 Word 时图片不显示？	检查图片路径，推荐用相对路径 `./images/xxx.png`
公式渲染不对？	确保用 $...$ 或 `$$...$$` 包裹，并安装 Markdown Preview Enhanced
表格在 Word 中错位？	导出后手动调整列宽，或者用 Word 模板固定样式
如何生成目录？	在 Markdown 中输入 `[TOC]` 并配合 Markdown All in One 插件自动生成

六、总结

用 VS Code + Markdown 写文档，本质上是把排版控制权交还给工具，让自己专注于内容。虽然初期需要一点配置，但一旦上手，你会发现：

再也不怕文档打开乱码
再也不用手动调整几百个段落的缩进
再也不用担心 Word 崩溃丢稿
版本控制、协作编辑变得无比轻松