Markdown-It

一、前置准备：确认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）： ...

1. 环境准备与依赖选型 在构建一个现代 Markdown 实时预览器前，明确技术栈边界是安全与可维护性的第一道防线。本教程默认采用纯前端、浏览器运行环境（兼容 Vite/React/Vue/甚至原生 HTML 页面），不依赖服务端渲染——这意味着所有解析、渲染、防护逻辑必须在客户端健壮执行。 ✅ 基础要求： Node.js ≥ 18.0（确保 ESM 原生支持与现代 API 兼容性） 构建工具无强绑定：markdown-it 是纯 JS 库，import 即用，Vite/Webpack/Rollup 均无缝支持 🔍 主流 Markdown 解析库横向对比： 库 XSS 默认防护 插件生态 性能（10KB 文档） 维护状态 备注 marked ❌（需手动禁用 html: true） 中等 ⚡ 快（但 v4+ 移除同步 API） 活跃 配置项少，扩展性弱于 markdown-it remark ✅（纯 AST，无 HTML 输出） ⚙️ 极强（统一 AST 生态） 🐢 中等（AST 转换链长） 活跃 学习成本高，需搭配 rehype-stringify 等，适合复杂处理流 markdown-it ✅（默认 html: false，xhtmlOut 安全） 🌟 丰富（>200 官方/社区插件） ⚡⚡ 快（C 语言级优化 parser） 活跃 推荐首选：开箱即用的安全基线 + 插件即插即用 ⚠️ 明确避坑： ...