SoloMD

一、开门见山：它不是Typora的平替，而是「写作本能」的回归 实话讲：用满30天后，我亲手卸载了Typora（v1.9）、Obsidian（连插件生态都清空了）、甚至VS Code里那套精心配置的Markdown工作流——不是因为它们变差了，而是因为**“写”这件事，终于不再需要我做任何决定**。 这不是玄学。是实测数据在说话：SoloMD macOS版安装包仅 14.3 MB（Typora同期版本120 MB），M2 MacBook Air冷启动平均耗时 412ms（Typora同环境实测1340ms，快3.2倍）。更关键的是，它没有“加载中”动画、没有项目初始化弹窗、没有同步账户登录页——双击图标 → 输入文件名 → 回车 → 光标已闪烁在首行。整个过程像拉开抽屉取纸笔一样自然。 它的哲学就刻在启动界面上：One file. One window. Just write. 这不是一句slogan，而是产品架构的硬约束：没有侧边栏导航树，没有资源库管理面板，没有云端账户体系。它不帮你“组织知识”，只确保你思想涌出的0.5秒内，键盘敲下的字符已真实落盘为.md文件。当我第7次在会议中途切出窗口、3秒内记下关键反驳点并自动保存时，我意识到：所谓生产力，有时就是把“要不要新建文件”“该存到哪个文件夹”“同步会不会冲突”这些认知杂音，从写作回路里彻底物理删除。 二、为什么「轻」反而成了生产力核弹？三个真实场景拆解 🖼️ 场景1：凌晨2:17的灵感闪念，比咖啡因还快 上周三凌晨，我被一个产品逻辑漏洞惊醒。摸黑打开MacBook，点开Dock里的SoloMD图标 → 键入 solomd bug-20240522.md → 回车 → 0.8秒后光标已在文档首行等待。随手截图（Cmd+Shift+4）→ 粘贴（Cmd+V）→ 图片瞬间嵌入，自动存为 ./assets/bug-20240522-1.png（路径相对当前文件），Exif信息已被裁剪，不泄露手机型号和GPS。整个过程没触发一次鼠标移动，没打开任何设置页。而同样操作在Obsidian里，我要先确认是否在正确Vault、等索引重建完成、再手动拖拽图片——等做完，灵感早凉了半截。 📊 场景2：技术文档交付，告别CSS炼狱 给客户写API文档，需公式推导（$∇·E = ρ/ε₀$）、状态流转图（stateDiagram-v2\n[*] --> Idle\nIdle --> Processing: POST /api/v1/jobs）、以及中文段落对齐。SoloMD原生支持KaTeX（公式实时高亮变色，非静态渲染）、Mermaid Live Preview（拖拽节点即时重排，无需刷新预览窗），且中文字体默认调用系统级字体：macOS走San Francisco，Win11走HarmonyOS Sans，Linux走Noto Sans CJK——零配置，开箱即合规。对比Typora，我曾为让中文标点不撑破代码块，反复调试theme.css长达2小时；而SoloMD里，我直接粘贴完就导出了。 📤 场景3：客户只要Word？3秒生成矢量级交付物 法务同事要求最终稿必须是.docx，且图表不能糊成位图。Cmd+Shift+P呼出命令面板 → 输入“export” → 选「Export to DOCX」→ 回车。1.7秒后，桌面出现note.docx：标题层级完美映射为Word样式、代码块保留Syntax Highlighting（Python关键字蓝色、字符串绿色）、Mermaid流程图以SVG矢量格式嵌入（在Word 365中放大10倍仍锐利）。而Typora同类操作需先切换主题预览、手动调整导出模板、再二次导出修正格式——SoloMD用一次点击，把交付链路压缩到了呼吸之间。 ...

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