Skip to content

Marksmith 墨匠 ​

结构感知、本地优先的 Markdown 桌面工作台:删除也有语义

当前版本v0.4.2(2026-10-20)
Git 标签v0.4.2(另有 v0.4.1、v0.3.0、v0.2.1、v0.2.0、v0.1.0)
状态可用(0.4.2,提供 Windows 安装包下载)
平台Windows(NSIS 安装包;macOS / Linux 打包未落地)
技术栈Tauri 2(Rust + WebView2)+ Svelte 5 + TipTap 3(ProseMirror)+ Vite + TypeScript;Mermaid 12 本地渲染、KaTeX、Shiki;bun 管依赖
许可木兰 PSL-2.0(Mulan PSL v2)

项目是做什么的 ​

Marksmith / 墨匠是一个本地优先的 Markdown 桌面工作台,面向每天跟 Markdown 打交道的人:写文档、写方案、写笔记,又不愿意为「结构化内容」反复切预览。

它把编辑区做成块级所见即所得:表格、任务列表、公式、Mermaid 图都直接渲染;同时保证「没动过的块原样保留」——不会因为你打开过一次就把整篇文档重排。

最有意思的一处是删除意图解析器:在结构边界按退格或 Delete 时它会停下来问你「要删字符、删整块,还是只拆结构」,把光标级删除这件事讲清楚,而不是让用户猜。

数据都在本机:文档是你自己的文件,图表渲染有本地缓存,Git 集成走本机命令行;目前只提供 Windows 安装包。

核心能力 ​

  • 关窗不丢数据:点 X 时弹「保存并关闭 / 不保存并关闭 / 继续编辑」三选一,写盘失败就留在窗口里说明原因(0.4.1 修掉了「点 X 关不掉程序」)
  • 删除意图解析器:在表格 / 列表 / 代码块 / 图片等结构边界按 Backspace、Delete 时,弹窗让你选「删什么语义」,而不是闷头删字符
  • Markdown 往返保真:没有改动的块逐字节保留原始源码,只有改动块重新序列化
  • 结构还原:被「按文本合并」降级成源码的表格 / 图表 / 代码块 / 公式,可以在源码上右键还原回结构(0.4.0 补全了代码块裸源码与「段里夹着源码」两条路径)
  • 块级所见即所得(TipTap 3 + ProseMirror):标题、列表、任务、表格、公式直接在编辑区渲染
  • Mermaid 本地渲染 + Rust 磁盘缓存(按 内容哈希+主题 缓存),带防抖、超时与错误回退
  • 图片:原始清晰度显示、点击进灯箱(滚轮 10%–1000% 缩放、可拖拽平移),粘贴/拖放的内容按内容寻址落盘
  • 导出:单文件 HTML(内联 CSS 与 SVG)与 PDF(调用本机 Edge/Chrome 无头打印)
  • Git 集成走命令行:状态、分支、领先/落后、变更列表、diff 与提交
  • Tauri 2 打包,安装包 10–20 MB 量级,内存占用远低于 Electron 方案
  • 自绘右键菜单:链接 / 图片 / 图表 / 公式 / 表格 / 文本各有专属动作,并屏蔽 WebView2 的原生菜单(输入框里仍保留系统菜单)
  • 最近文件:侧栏列最近 5 个,「更多最近文件」窗口可按文件名 / 路径筛选、打开、单条移除与清空
  • 浮层会自己找位置:气泡菜单与表格菜单贴边时先翻转、再夹进视口,不会跑到屏幕外(有单元测试)
  • 打开项目 / 文档后不再闪命令行黑框:git / mmdc / headless 浏览器等子进程统一加 CREATE_NO_WINDOW(0.4.2)

界面截图 ​

点击任意截图可放大查看;截图都是本机真实运行程序后截的。

主界面
主界面
打开一篇 Markdown 后的编辑态:顶栏是格式化工具(标题/列表/表格/公式/Mermaid/导出/设置),左栏工作区与最近文件,底栏实时显示词数、字符数、块数、Git 变更与图表缓存占用
结构删除对话框
结构删除对话框
删除意图解析器:在表格边界按退格,弹出 5 个明确的删除语义(删整张表 / 删最后一行 / 只删空行 / 转成表格文本 / 取消),背景里受影响的表格被红框标出,还可以「记住我的选择」
Mermaid 与公式
Mermaid 与公式
同一篇文档里:Mermaid 代码块本地渲染成流程图(带磁盘缓存)、Rust 代码块高亮、行内与块级 KaTeX 公式都已排版
表格工具栏
表格工具栏
点进表格单元格弹出的表格工具栏:上/下方插行、删除行、左/右插列、表头切换、合并与拆分、对齐、删除表格
浮动工具栏
浮动工具栏
选中文字后浮出的行内工具栏:加粗、斜体、删除线、行内代码、高亮、加链接
图片灯箱
图片灯箱
点文档里的图片进灯箱:按原始清晰度显示、可缩放(10%–1000%)与拖拽平移,底部有缩放比例与「适应窗口」
设置面板
设置面板
设置:主题(浅色 / 深色 / 跟随系统)、正文字号、专注模式、自动保存与空闲间隔、外部修改监听,以及 Mermaid 主题、渲染防抖与超时
深色主题
深色主题
深色主题下的正文视图(打开的是一份设计走查文档)
右键菜单
右键菜单
0.2.0 新增的自绘右键菜单:在正文里右击给出剪切 / 复制 / 粘贴 / 全选,并屏蔽掉 WebView2 那个英文原生菜单(输入框里仍保留系统菜单)
右键菜单·表格
右键菜单·表格
同一套菜单按上下文换动作:表格上是插行 / 插列 / 合并(不可用时置灰)/ 删除整张表(红色危险项);深色主题下配色与文档一起跟随
最近文件
最近文件
0.2.0 新增的「更多最近文件」窗口:可按文件名或路径实时筛选,悬停行尾出现「从列表移除」,底部可清空列表;侧栏另外常驻最近 5 个
窗口标题(0.2.1 修复)
窗口标题(0.2.1 修复)
0.2.1 修好了「窗口标题永远不更新」:标题栏现在显示文件名,前面的圆点是「已修改」标记(0.2.1 还修了光标在正文里时 Ctrl+N / Ctrl+O 失效、状态栏图表缓存计数滞后两个缺陷)

关于截图

截图都是在本机真实运行的(0.1.0 那批是 Tauri debug 构建 + 应用默认窗口 1280×840;0.2.x 那批走仓库自带 CDP 走查脚本,真实鼠标/键盘事件驱动):删除意图对话框由真实退格按键在表格边界触发;Git 面板那张因为当时面板里打开的是本站仓库、与项目页无关,未收录。

下载 ​

  • Marksmith_0.4.2_x64-setup.exe —— 6.5 MB,Windows 10/11 安装包(NSIS,当前用户安装,带 .md/.markdown 文件关联);未签名,首次运行可能被 SmartScreen 拦一下(更多信息 → 仍要运行)|SHA256 eafa6d98359e57cbf0819d901d79780a716ab76fb0334b837fc732104ecf6892

发版记录 ​