墨知

英文名：Mozi。

English · 开发文档

本地优先的 Markdown 编辑器。把文件夹当知识库，笔记就是普通 .md 文件。正式版以 Live 模式写作，并可一键发到微信公众号草稿或 Simple Blog。

目标：比 Typora 更顺手、比 Obsidian 更轻量的纯 Markdown 写作体验。

下载安装

在 GitHub Releases 获取当前平台的安装包。

macOS

推荐：一键安装（自动下载、移除隔离标记并安装到「应用程序」）

curl -fsSL https://raw.githubusercontent.com/Yunz93/Mozi/main/scripts/install-macos.sh | bash

指定版本（可选）：

RELEASE_TAG=v1.0.7 curl -fsSL https://raw.githubusercontent.com/Yunz93/Mozi/main/scripts/install-macos.sh | bash

已配置 Apple 开发者证书与公证凭据的 Release 通常也可直接拖入「应用程序」打开。若系统仍提示无法验证开发者，将 墨知.app 放入「应用程序」后执行：

xattr -cr /Applications/墨知.app

若仍在「下载」中，把路径换成 ~/Downloads/墨知.app。

证书与公证配置见 开发文档 - macOS 签名公证。

Windows

运行 .exe 安装。SmartScreen 提示时选「更多信息」→「仍要运行」。安装后可在 设置 → 关于 检查 GitHub Release 更新。

新功能介绍

Live 模式

正式版只保留 Live 和阅读，已去掉纯编辑和分屏。Live 边写边渲染，所见即所得。

一键发布

• 微信公众号草稿：配好公众号后，按预渲染样式发到草稿。用公众号助手查看后再发布。
• Simple Blog：配套博客网页，部署到 Vercel 后即可从墨知推送上线。仓库地址、公开站点与 GitHub Token 在 设置 → 发布 里填写。

图片分享

一键把当前文章生成分享长图，适合发到社交媒体。

小知助手

内置本地语义检索，支持全库搜索；也可配置在线模型做智能问答，回答会带来源。

Excalidraw 画板

侧边栏新建即可使用，也兼容 Obsidian 的 .excalidraw.md。笔记里可用 ![[drawing.excalidraw]] 嵌入预览。

Markdown 便捷编辑

空行输入 / 可插入表格、提示文本、代码块、Mermaid 图表和待办事项，对 Markdown 新手比较友好。

项目地址：github.com/Yunz93/Mozi，欢迎 Star / Fork。

常用快捷键

默认键位；完整列表见 Settings → Shortcuts。

快捷键	动作
Cmd/Ctrl + S	保存
Cmd/Ctrl + 0	设置
Cmd/Ctrl + 1 ~ 5	侧边栏 / Outline / 视图模式 / 主题 / AI 增强
Cmd + Shift + F	当前文件搜索
Cmd + Shift + S	侧边栏搜索
Cmd + Shift + B / J	打开知识库 / 定位当前文件
Cmd + Shift + E	导出 PDF
Cmd/Ctrl + N / Cmd/Ctrl + Shift + N	新建笔记 / 文件夹
Cmd/Ctrl + Shift + Alt + N	新建窗口（桌面端）
Cmd/Ctrl + W	关闭标签
Cmd/Ctrl + + / Cmd/Ctrl + -	放大 / 缩小界面文字
Cmd/Ctrl + Shift + 0	重置界面文字大小
Cmd/Ctrl + Shift + -	清理未引用附件
Escape	关闭搜索面板、弹窗或菜单

发布到 simple-blog

在 Settings → Publishing 填写：

• Blog Repository URL（https://github.com/owner/repo、git@github.com:... 或 owner/repo）
• 博客公开地址（用于回写 frontmatter 中的 link，如 https://你的域名 或 xxx.vercel.app）
• GitHub Token：Fine-grained PAT，对目标仓库开启 Contents: Read and write

发布后应用会保存当前笔记、写入 is_publish: true，同步 posts/ 与图片到仓库、改写图片为 raw 链接，并由 GitHub 推送触发 Vercel。

常用 frontmatter：title、aliases、slug、link（发布后回填）、status（写作状态，不参与是否发布）、is_publish。未填 title / aliases / slug 时可用文件名或标题推导；仓库内文件名不因 slug 改变。

发布到微信公众号草稿

同一设置页配置 AppID、AppSecret（仅本机安全存储）。工具栏选择微信公众号渠道：填写标题/作者/摘要/原文链接，封面发布时选择；正文本地图片会上传。首次发布会写入 wechat_draft_media_id，再次发布同一篇则更新原草稿。当前为单账号、单图文草稿；若使用服务器域名调用接口，需将出口 IP 加入微信公众平台白名单。

许可证

Apache License 2.0

致谢

墨知 建立在大量优秀开源项目之上（排名不分先后）。下列为产品运行时直接依赖的主要组件；完整版本与传递依赖见仓库中的 package.json / package-lock.json 与 src-tauri/Cargo.toml / Cargo.lock。

桌面与界面

项目	用途	许可
Tauri（含 API 与 dialog / fs / process / shell / updater 等插件）	桌面壳、文件系统、对话框、更新	Apache-2.0 OR MIT
React	UI	MIT
Zustand	应用状态	MIT
Vite	前端构建	MIT
Tailwind CSS	样式	MIT
Lucide（lucide-react）	图标	ISC

编辑器

项目	用途	许可
CodeMirror 6（@codemirror/*，含 Markdown / 多种代码语言）	Live 编辑、语法高亮、选区与装饰	MIT
Lezer Highlight	语法高亮标签	MIT
@replit/codemirror-lang-csharp	C# 语言支持	MIT

Markdown、预览与画板

项目	用途	许可
markdown-it	Markdown 解析	MIT
markdown-it-footnote	脚注	MIT
markdown-it-task-lists	任务列表	ISC
GitHub Markdown CSS	预览基础样式	MIT
Shiki	代码高亮	MIT
KaTeX	数学公式	MIT
Mermaid	流程图等图表	MIT
beautiful-mermaid	Mermaid 渲染辅助	MIT
DOMPurify	HTML 消毒	MPL-2.0 OR Apache-2.0
Excalidraw（@excalidraw/excalidraw）	手绘白板编辑与嵌入预览	MIT
lz-string	Obsidian 图纸压缩格式	MIT
Turndown	HTML → Markdown	MIT
js-yaml	YAML frontmatter	MIT

导出、PDF 与文档渲染

项目	用途	许可
PDF.js（pdfjs-dist）	PDF 预览	Apache-2.0
html2canvas	预览光栅化	MIT
html2pdf.js	HTML → PDF	MIT
jsPDF	PDF 生成	MIT

知识检索与可选 AI

项目 / 服务	用途	许可 / 说明
Hugging Face Transformers.js（@huggingface/transformers）	内置本地 embedding	Apache-2.0
Google Gen AI SDK（@google/genai）	可选 Gemini 调用	Apache-2.0
Google Gemini / OpenAI 兼容接口	可选云端或本地（如 Ollama）模型	第三方服务条款

Rust 侧还依赖 serde、reqwest、uuid 以及加密封装相关 crate（如 chacha20poly1305、hmac、sha2 等），用于配置安全存储与网络请求等桌面能力。

若发现致谢遗漏，欢迎提交 Issue 或 PR 补充。