Personal Math Snippets

Personal Math Snippets 是一个面向 Markdown 和 LaTeX 的 VS Code 数学输入扩展。

它的定位不是从零重新发明一套 snippets 体系，而是在现有主流数学 snippets 使用习惯的基础上做组合、筛选和优化：

• 吸收常见数学 snippets 插件里高频、顺手的规则设计
• 统一 Markdown 与 LaTeX 中的数学输入体验
• 补上动态矩阵、动态向量、动态根式等更灵活的规则
• 提供可关闭的规则分组，减少冲突
• 保留自定义空间，方便继续调整为自己的写作习惯

安装

如果你已经拿到了 .vsix 安装包：

1. 在 VS Code 中执行 Extensions: Install from VSIX...
2. 选择安装包
3. 安装完成后重载 VS Code

功能特点

• 数学环境感知：只在合适的上下文中触发数学规则
• 自动展开与候选栏展开并存
• 支持 Markdown 和 LaTeX 共用的大部分数学规则
• 支持动态矩阵、动态向量、动态根式
• 支持按规则分组关闭内置功能
• 支持查看完整规则总表与测试说明

使用方式

本扩展主要有两种触发方式：

• 自动展开：输入完整 trigger 后立即替换
• 候选栏展开：输入完整 trigger 后从建议列表中确认展开

常见示例：

• im、dm：插入行内/行间数学环境
• fr：插入 \frac{...}{...}
• @a：自动展开为 \alpha
• alpha：在候选栏中展开为 \alpha
• bmat4：生成 4x4 矩阵模板
• sq3：生成 \sqrt[3]{...}
• tt：生成 \text{...}
• sum、prod、int、oint：常用大算子模板

作用域

• 在 Markdown 中，数学规则只在数学环境内生效；数学包裹器规则可在普通文本中使用
• 在 LaTeX 中，数学规则只在数学环境内生效；文档结构、环境、文本格式规则可在普通文本中使用
• 数学包裹器 im / dm / mk / dmk 同时支持 Markdown 和 LaTeX 文本环境

命令

命令面板中可用：

• Personal Math Snippets: Reload Rules
• Personal Math Snippets: Open Rule Reference
• Personal Math Snippets: Open Rules Folder

安装完成后，如果想查看完整规则总表与测试说明，直接运行 Personal Math Snippets: Open Rule Reference 即可。

设置

支持通过设置按分组关闭内置规则：

• personalMathSnippets.disabledRuleGroups

这个设置接收一个字符串数组，每一项都是相对 rules/ 的路径前缀。

示例：

{
  "personalMathSnippets.disabledRuleGroups": [
    "math/symbols",
    "latex/environments",
    "markdown/wrappers"
  ]
}

规则总表

完整规则总表与测试说明可通过插件命令打开，也包含在扩展包内的 docs/testing-guide.md 中。