[App Sharing] 我在 deepin v23 上开发的「基于 Git 同步」Markdown 笔记应用
Tofloor
poster avatar
ailingyue
deepin
6 hours ago
Author

大家好,分享一下我最近在做的开源项目 即记 (Jot) —— 一款面向 Linux 桌面的 Markdown 笔记应用。

定位和 Obsidian / Joplin 类似,但有个关键区别:笔记就是磁盘上真实的 .md 文件,直接操作文件系统,没有数据库、没有专有格式、不需要导入导出。工作方式更像 VS Code / IDEA —— 打开一个目录,所有笔记都在那里,用其他任何编辑器也照样能读。

为什么做这个?

我自己的痛点是:笔记工具一旦形成私有格式,想迁移出来就很痛苦。所以 Jot 从设计上就坚持「文件即笔记」—— 你把笔记目录当做一个普通文件夹管理,git 仓库也是现成的。

一点背景:全程在 deepin v23 上开发

这个应用从编码到日常使用,全程都在 deepin v23 上完成,Linux 桌面算是它的"主场"。安装、运行、打包(.deb)都是在这套环境里实测过的,不会出现"Windows 上跑得好好的、Linux 上一堆毛病"的情况。

开发过程中大量使用了 DeepSeek、Kimi 等大模型做辅助编码,从架构设计到修 bug 都有参与,算是一个"在 Linux 上用 AI 写桌面应用"的实践案例,有兴趣的可以交流。

技术栈是 Tauri 2 + Rust 后端 + React 前端,体积小、内存占用低、启动快,不吃 Electron 那套资源,在 Linux 上体验很清爽。


核心功能速览

📝 编辑体验:基于 CodeMirror 6,所见即所得(隐藏 Markdown 语法直接显示粗体、标题、表格、图片),随时切源码模式改原始 Markdown。

🔄 Git 自动同步:编辑停笔 2 秒自动保存 → 空闲 30 秒自动提交 → 每 5 分钟自动推拉。冲突时自动处理并保留冲突副本,多设备同步完全不用手动管。

📁 原生文件系统:笔记按真实目录组织,拖入图片自动存入 .assets/,和 VSCode、Typora 等其他编辑器完全兼容。

🧠 知识库能力[[wiki 链接]] 自动补全 + 反向链接面板;Cmd+P 命令面板同时搜文件名和正文。

📋 模板系统_templates/ 里放模板,新建一键套用,支持 {{title}}{{date}} 变量。

🎨 丰富内容:KaTeX 公式、Mermaid 图表、代码高亮、任务待办,全都支持。

📤 多格式导出:HTML(公式自包含)、PNG、PDF,若装 Pandoc 还可转 DOCX / EPUB / LaTeX。

🌗 双主题(亮/暗色),界面文案全部中文,为中文用户设计。


app.png


deepin / UOS 安装

Releases 已提供 .deb 包,deepin 上直接双击或用命令安装即可:

下载https://github.com/fatefl/jot/releases

  • deepin/UOS:jot_0.1.17_amd64.deb
  • 其他 Linux 发行版:.AppImage 免安装
  • Windows / macOS:.msi / .dmg

运行时依赖:WebKitGTK(Tauri 2 标准依赖),deepin 20+/23 一般自带,缺的话装一下 libwebkit2gtk-4.1-0 就行。


项目状态

当前版本 v0.1.17,MIT 开源。
GitHub 仓库:https://github.com/fatefl/jot

  • 跨平台:Linux / Windows / macOS
  • 内置 MCP sidecar,支持 AI 助手直接读笔记(感兴趣的可以试试)
  • 我每天实际在用的日常工具,迭代比较快,欢迎提 issue 和 PR

最后

刚起步的项目,非常需要真实用户反馈。有任何问题(闪退、安装、同步、功能建议)都可以直接回复这个帖子,或者去 GitHub 提 issue:

https://github.com/fatefl/jot/issues

如果对你有用,点个 Star 就是最大的支持,感谢! ❤️

Reply Favorite View the author
All Replies
avatar
Ligocut光剪视频剪辑软件
deepin
Backbone of ecological co-construction group
5 hours ago
#1

私有仓库也可以吗?

一开始的git鉴权是打开网页登录的模式吗?

Reply View the author
avatar
ailingyue
deepin
an hour ago
#2
Ligocut光剪视频剪辑软件

私有仓库也可以吗?

一开始的git鉴权是打开网页登录的模式吗?

可以使用私有仓库,仓库账号密码登陆授权或者token授权,首次使用会引导配置

Reply View the author