第八步:插件初探——为soloMD添加TOC和代码块复制功能
一、前置准备:确认soloMD环境与插件机制 在集成任何 Markdown 渲染增强功能前,必须确保开发环境与 soloMD 的插件扩展机制完全兼容。soloMD 自 1.5.0 版本起全面拥抱 Vite 生态,其 Markdown 渲染层基于 markdown-it 构建,并通过 markdownConfig 显式暴露插件注入入口——这不是一个“开箱即用”的黑盒,而是一个可编程的渲染流水线。 首先,请执行以下两条命令验证基础环境: npm list solomd # ✅ 正确输出示例:`└── [email protected]` node -v # ✅ 要求输出 v18.17.0 或更高(推荐 LTS v18.20.2+) ⚠️ 若 npm list solomd 报错或版本低于 1.5.0,请先升级: npm install solomd@latest 并确认 package.json 中 "type": "module" 已设置(Vite 项目必备)。 soloMD 的项目结构遵循标准 Vite 模式: src/ ├── components/ ├── pages/ ├── App.vue └── main.ts ← 渲染初始化入口(常见配置位置) public/ package.json vite.config.ts ← 更推荐的插件配置位置(全局生效) 关键配置入口有两个,优先级顺序为:vite.config.ts > main.ts。你只需选择其一即可(本文统一使用 vite.config.ts): ...