如何在 VS Code 中通过 CodeGeex 插件实现对多种 Markdown 语法的支持

有个事情必须先说清楚——CodeGeeX在VS Code里装好之后，务必要重启一下编辑器，不然那些智能补全功能压根不会响应。它支持用英文提示词来触发各种Markdown语法的自动生成，比如表格、代码块、LaTeX公式都可以。提示词的格式要求比较具体，得是动词接具体元素的写法，比如“create a table”这种。生成出来的内容最好自己再扫一眼语法是否完整，插件不负责查漏补缺。

安装并启用CodeGeeX插件

打开VS Code之后，按Ctrl+Shift+X进入扩展市场，搜索

，找到之后点“安装”就行了。关键在于安装完之后必须重启VS Code，否则插件就算显示“已启用”，像Markdown补全、表格生成、公式建议这些功能统统不会生效。这一步不能跳过。

触发Markdown语法智能补全

新建一个.md文件，在任意位置输入一个英文提示词。比方说：create a markdown table with 4 rows and 3 columns，或者generate a checklist with 5 items。

输入完成后按Tab键，或者点一下弹出的补全建议框里的“插入”按钮，CodeGeeX就会自动生成对应的Markdown代码结构。

需要留意的是：提示词必须用英文，而且得包含明确的动作动词（像是create/generate/insert）加上具体的元素描述（比如table/checklist/code block）。如果用中文，或者描述比较模糊（比如“弄个表格”），补全功能是触发不了的。

快速生成对齐规范的表格

操作上有三种方式可以走：

第一种：直接在编辑器里输入table，接着按Tab键，就能得到一个三列的基础表格框架。

第二种：输入更精确的提示词，比如make a left-aligned markdown table for project tasks with columns: Task, Status, Due Date，再按Tab键——这时生成的表头分隔行会自动带上冒号对齐语法，像|:---|:---|:---|这样。

第三种：如果手头已经有了一段没有对齐符的普通表格文本，直接选中它，右键选择

，插件就会自动补全并修正分隔线格式，保证各列严格左对齐。

有一点要注意：如果生成结果里缺了:这个对齐标记，需要手动加回去，否则在预览里对齐效果出不来。CodeGeeX对已有错误格式不会自动修复，它只管新生成内容的语法校验。

插入带语法高亮的代码块

第一步：把光标放在要插代码的位置，输入类似insert python code snippet for reading a csv file这样的提示词。

第二步：按Tab键，CodeGeeX就会输出完整的代码块，包括语言标识（```python）和正确的缩进结构。

第三步：检查一下生成的代码是否被成对的反引号包住。如果只出现一侧反引号或者漏掉了语言名，VS Code是没法启动语法高亮的，得手动补上。

辅助编写LaTeX数学公式

在文档里输入提示词：write inline latex formula for quadratic equation，然后按Tab键，就能得到$x = frac{-b pm sqrt{b^2 - 4ac}}{2a}$这样的行内公式。

如果需要块级公式，改用display centered quadratic formula as block equation这样的提示词——CodeGeeX会输出用$$ ... $$包裹的公式。

插件生成的公式默认采用LaTeX语法，但不会做符号有效性校验。所以如果有花括号没闭合，或者下划线放错了位置，预览区看到的会是原始代码而不是渲染后的公式。这一点需要自己留心。