markdown-plus-plus v3重大更新:新特性与迁移指南
markdown-plus-plus是一款专为Notepad++设计的Markdown语法高亮工具,通过自定义用户定义语言(UDL)XML文件实现。v3版本带来了多项重要改进,包括npm包支持、简化的构建系统和增强的主题管理,让Notepad++用户获得更优质的Markdown编辑体验。
🚀 核心新特性一览
1. 全新npm包体验
v3版本最大的变化是将项目重构为npm包,现在你可以通过命令行直接获取UDL文件:
:: 检查Node.js是否安装
node -v
:: 直接使用npx命令下载主题
npx markdown-plus-plus solarized-light
:: 或者全局安装后使用mpp命令
npm install --global markdown-plus-plus
mpp --list :: 查看所有可用主题
2. 优化的文件结构
项目采用更清晰的目录结构,让主题管理和自定义变得简单:
- udl/: 存放所有主题的UDL XML文件,如markdown.default.udl.xml
- config/: 主题配置文件目录,如markdown.material.config.json
- test/: 测试文件目录,包含at-a-glance.md示例文件
3. 增强的暗模式支持
Notepad++ v8.1.3+的暗模式功能得到更好支持,每个主题现在提供两个版本:
:: 下载普通模式主题
mpp solarized
:: 下载暗模式主题
mpp solarized --dark
NPP会自动根据当前模式选择合适的UDL文件,文件名遵循规范:
- 普通模式:
markdown.[theme-name].udl.xml - 暗模式:
markdown.[theme-name].dark.udl.xml
4. 可配置的语法高亮选项
v3版本引入了灵活的配置选项,你可以在配置文件中自定义高亮行为:
| 选项 | 描述 |
|---|---|
goodies.highlightHex | 高亮HEX颜色值 |
flags.transparentBg | 使文本背景透明(谨慎使用) |
flags.asteriskUnorderedList | 启用星号风格列表(* 列表项) |
📷 主题展示
v3版本提供多种精美主题,满足不同用户的视觉偏好:
Markdown默认主题高亮效果
Markdown Material主题高亮效果
Markdown Solarized主题高亮效果
🔄 从v2迁移指南
主要变化
| v2版本 | v3版本 |
|---|---|
| 每个主题有Modern和Classic两个构建 | 仅一个构建,Classic特性通过选项控制 |
| 分散的文件结构 | 集中的udl/和config/目录 |
| 手动下载安装 | npm包管理,命令行安装 |
迁移步骤
-
卸载旧版本UDL文件
- 删除
%AppData%\Notepad++\userDefineLangs目录下的v2版本文件
- 删除
-
安装v3版本
npm install --global markdown-plus-plus -
下载所需主题
mpp solarized-light :: 安装浅色主题 mpp solarized --dark :: 安装对应暗模式主题 -
重启Notepad++完成迁移
🛠️ 高级使用:构建自定义UDL文件
如果你需要定制自己的语法高亮规则,可以通过以下步骤构建自定义UDL文件:
-
克隆仓库
git clone https://gitcode.com/gh_mirrors/ma/markdown-plus-plus cd markdown-plus-plus npm install -
修改配置文件
- 在config/目录下复制现有配置文件并修改,如复制markdown.default.config.json
-
构建UDL文件
npm run build -
生成的UDL文件将保存在udl/目录下
❓ 常见问题
Q: 为什么星号列表(* 列表项)不生效?
A: 为避免与某些URL格式冲突,星号列表默认禁用。可通过修改配置文件启用:
"flags": {
"asteriskUnorderedList": true
}
Q: 如何更新到最新版本?
A: 全局安装用户可使用命令:npm update markdown-plus-plus
Q: 支持哪些Notepad++版本?
A: 推荐使用Notepad++ v8.4.4及以上版本,暗模式功能需v8.1.3+
📝 结语
markdown-plus-plus v3版本通过npm包管理、优化的文件结构和增强的配置选项,为Notepad++用户提供了更便捷、更灵活的Markdown语法高亮解决方案。无论你是新手还是高级用户,都能通过简单的命令快速部署或定制属于自己的Markdown编辑环境。
立即尝试v3版本,提升你的Markdown编辑体验吧!
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



