Skip to content

About

本地优先的结构化 Markdown 笔记与知识工作台。原生集成 Git 版本控制、Draw.io 绘图、GeoGebra 建模、思维导图、KDBX 密码库(含 2FA & SSH 直连)及 PDF 专业批注。| Local-first structured Markdown notes & knowledge base with Git, Draw.io, GeoGebra, MindMap, KDBX & PDF.

Topics

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

MarkNotePro

MarkNotePro

集成 Git、Draw.io、GeoGebra、MindMap、KDBX 加密密码库(含 2FA & SSH 直连)与 PDF 专业阅读批注的本地 Markdown 笔记与知识工作台
用本地目录管理知识库,原生支持 Markdown 笔记、Draw.io 专业绘图、GeoGebra 数学建模、MindMap 思维导图、KDBX 加密密码库与 PDF 专业阅读批注,用 Git 做版本管理、同步和恢复。
支持 Linux、macOS、Windows。
简体中文 | English

产品定位

MarkNotePro 是一款本地优先的结构化知识管理与多模态创作工作台。围绕笔记工作区建立体系化知识库,左侧分区管理文档,右侧原生集成 Markdown、Draw.io 架构图、GeoGebra 数学建模、MindMap 思维导图与 PDF 专业阅读批注,支持 txt、json 等常用文本简单编辑;内置 KDBX 加密密钥库及 2FA 动态口令,提供 SSH 终端直连(必须建立密钥库,通过密钥库直连、自动 2FA 验证),并无缝联动 Git 进行版本管理、提交与同步。

它适合这些场景:

  • 把个人笔记、技术架构图、数学/理工科推导、思维导图、PDF 资料批注、服务器凭据与长期知识库放在同一个本地目录中管理。
  • 使用开放通用的本地文件格式(.md、.drawio、.ggb、.smm、.kdbx、.pdf)保存内容,避免被专有云服务锁定。
  • 在同一工作区内直接创建和编辑 Draw.io 流程图/架构图、GeoGebra 数学建模、MindMap 思维导图以及阅读与批注 PDF 文档(支持文本高亮、手绘涂鸦、文字批注、图章图片与签名,快捷键原地覆盖保存),全程离线可用。
  • 通过 GitHub、Gitee、Coding 或其它 Git 服务同步整个知识库目录,在多台电脑之间无损同步、回滚、查看历史版本。
  • 希望知识库结构清晰,不希望普通杂乱文件夹和笔记体系互相污染。

产品选择

MarkNotePro 和 MarkTextPro 是两个相互独立、但能力互补的产品:

  • MarkNotePro:本地结构化笔记与多模态知识工作台。强调笔记工作区、分区组、分区与结构化文档体系,原生集成 Markdown、Draw.io 绘图、GeoGebra 数学建模、MindMap 思维导图、KDBX 加密密码库(支持 2FA 动态口令与 SSH/终端直连)与 PDF 专业阅读批注,适合长期笔记、体系化知识库、专业资料与本地凭据管理。
  • MarkTextPro:本地自由文件与项目多模态工作区管理器。强调开放文件系统、自由文件夹、外部独立文档与代码项目管理,同样原生集成 Markdown、Draw.io 绘图、GeoGebra 数学建模、MindMap 思维导图、KDBX 加密密码库(支持 2FA 动态口令与 SSH/终端直连)与 PDF 专业阅读批注,适合代码仓库、外部技术文档和自由项目编辑。

相关地址:

两者均内置 Markdown、Draw.io、GeoGebra、MindMap、KDBX 加密密码库(含 2FA & SSH 终端直连)与 PDF 专业阅读批注等本地核心能力,并都深度集成 Git 工作区版本管理;这些能力与 Git 是二者的共同底座。选择时更应该看你需要“结构化多模态笔记工作台”还是“自由多模态项目文件管理器”。

下面是同一个项目在两个产品里的展示差异:MarkNotePro 只会展示符合笔记标准的目录与受支持文档(.md / .drawio / .ggb / .smm / .kdbx / .pdf),收敛为分区组 / 分区 / 文档视图;MarkTextPro 则展示真实文件系统结构,更适合完整项目目录和外部文件管理。

MarkNotePro 结构化笔记视图
MarkNotePro:只展示符合笔记标准的目录和知识文档
MarkTextPro 真实文件系统视图
MarkTextPro:展示完整真实文件系统结构

选择建议:

使用场景 / 需求 推荐产品
你希望像管理笔记本一样管理长期笔记、结构化知识库与项目资料 MarkNotePro
你需要在结构化笔记中直接进行 Markdown 写作、绘制 Draw.io 架构图/流程图、使用 GeoGebra 数学建模、绘制 MindMap 思维导图,或进行 PDF 批注阅读 MarkNotePro
你需要在结构化工作区中管理受主密码保护的 KDBX 密码库、密钥条目、2FA 动态口令并一键直连 SSH 终端 MarkNotePro
你接受并需要工作区、分区组、分区、文档这种结构化层级 MarkNotePro
你希望侧边栏只呈现笔记体系,减少普通杂乱文件夹带来的干扰 MarkNotePro
你主要在真实文件夹、代码仓库中工作,或频繁编辑外部独立文档与项目 README MarkTextPro
你需要在自由文件夹、项目仓库或外部路径中直接创建与管理 Markdown、Draw.io 架构图、GeoGebra 数学模型、MindMap 思维导图、KDBX 密码库(含 2FA & SSH 直连),或对 PDF 进行专业批注阅读 MarkTextPro
你希望保留真实文件系统目录结构,不希望被笔记层级约束 MarkTextPro
你需要一个更自由的本地多模态文件与项目工作区管理器 MarkTextPro

核心能力

  • 本地笔记工作区:首次使用必须选择工作区,所有笔记与专业创作文档围绕这个根目录组织。
  • 分区组 / 分区 / 多类型文档:用类似 OneNote 的结构统一管理 Markdown 笔记(.md)、Draw.io 绘图(.drawio)、GeoGebra 数学文档(.ggb)、MindMap 思维导图(.smm)、KDBX 密码库(.kdbx)、PDF 文档(.pdf)及常用文本,减少普通文件夹式管理的混乱。
  • 常用文本与配置轻量编辑:原生支持打开与编辑 .txt、.json 等通用纯文本与配置文件,支持轻量快速查看、修改与原地实时保存。
  • Tree / List 双模式:既可以使用纯树结构,也可以使用“分区树 + 文档列表”的方式快速定位笔记、图表、数学模型、思维导图、纯文本与 PDF。
  • Markdown 所见即所得编辑:支持标题、列表、任务、表格、引用、代码块、数学公式、Mermaid、警告块(Callouts)等常用 Markdown 能力。
  • 内置 PDF 专业阅读与批注引擎:本地离线集成 Mozilla PDF.js 全功能引擎,支持页面流式阅读、目录大纲导航、缩略图、多语言全文字符搜索、页面旋转与自适应缩放;深度集成丰富批注工具集:文本高亮(多色标记与透明度控制)、下划线/删除线、自由手绘涂鸦(Ink)、添加文本批注、插入图片/图章与电子签名;原生快捷键 Cmd+S / Ctrl+S 原地覆盖保存源文件(无多余另存为弹窗),修改红点状态精准双向同步,暗色/明亮主题自动适配。
  • 内置 Draw.io 专业绘图引擎:本地离线集成完整 Draw.io 编辑器,支持直接创建、编辑、自动保存 .drawio 图表文件,支持导出 PNG、JPEG、SVG、PDF、HTML、XML 等格式。
  • 内置 GeoGebra 数学与几何套件:本地离线集成官方 GeoGebra 全功能引擎,支持绘图计算、几何、3D 计算器、CAS(计算机代数)、概率统计与科学计算器六大模式,支持导出 .ggb、.png、.svg、.pdf、.stl 及打印。
  • 内置 MindMap 专业思维导图引擎:本地离线集成全功能思维导图工作台,原生支持思维导图、逻辑结构图、目录组织图、组织结构图、时间轴、鱼骨图等 6 种经典脑图结构;支持节点富文本、LaTeX 数学公式、节点图标/贴纸、超链接、关联线、概要节点、外框、备注与标签;提供大纲编辑与快捷键面板,支持导入 XMind / Markdown / .smm 并支持导出 PNG、SVG、PDF、Markdown、JSON 及直接调用系统打印。
  • 内置 KDBX 加密密码库(含 2FA & SSH 终端直连):基于 KDBXWeb 在本地创建、解锁和保存 KeePass 兼容的 .kdbx 密码库;支持分组、密钥条目、自定义字段、标签、附件、历史记录、回收站与主密码重置,并支持受提取码保护的批量密钥导入导出。深度集成 2FA 双因素动态口令(支持二维码扫描、截图粘贴与 URI 批量导入,实时倒计时与防重放);提供 SSH / 终端安全直连(必须建立密钥库,严格通过密钥库直连发起会话、登录自动 2FA 验证,并集成图形化 SFTP 文件管理器与 ZMODEM 传输)。
  • 工作区内链跳转与路径复制:支持在侧边栏一键复制文档相对工作区路径或 Markdown 链接,并在 Markdown 笔记中点击直达工作区内的其它笔记、Draw.io 图表、GeoGebra 文档、思维导图或 PDF 标签页。
  • 表格增强:支持表格批量编辑、复制粘贴、与 Excel 互操作等高频办公能力。
  • 本地附件与自包含资源:Markdown 插入本地图片时可自动复制到工作区 Attachments 附件目录并使用相对路径引用;GeoGebra 与 MindMap 中插入的图片等媒体资源则直接内嵌封装在文档内部,跨电脑同步不丢失。
  • 集成 Git 工作区:内置 Git 操作界面,支持仓库添加、克隆、变更查看、提交、分支、拉取、推送等操作。
  • 笔记工作区与 Git 仓库联动:可以从 Git 仓库切换笔记工作区,也可以在笔记根目录重命名后同步更新 Git 仓库路径。

内置创作与安全引擎:Draw.io、GeoGebra、MindMap、KDBX 与 PDF

除了 Markdown 写作,MarkNotePro 还将工程图表、理工科数学建模、思维导图、加密密码库与专业 PDF 阅读批注能力直接纳入同一个本地工作区,所有模块均随客户端本地打包、100% 离线可用,无需依赖外部网页或云端账号:

创作引擎 文件后缀 支持模式与核心特性 导出与格式支持
Draw.io 绘图引擎 .drawio 流程图、系统架构图、UML、ER 图、网络拓扑图、思维导图等完整图形库;支持多标签页保活切换、快捷键保存与自动保存状态同步 支持导出 PNG、JPEG、SVG、PDF、HTML、XML 等格式
GeoGebra 数学套件 .ggb
  • 绘图计算(Graphing):函数图像、导数积分、滑动条、数值表格与完整几何作图工具集
  • 几何(Geometry):尺规作图、多边形、圆锥曲线、度量与几何变换
  • 3D 计算器(3D Graphing):空间曲面、立体几何、空间向量与平面交线
  • CAS 计算机代数:符号微积分、方程精确求解、因式分解与矩阵运算
  • 概率统计(Probability):正态/二项/泊松等概率分布可视化与区间概率计算
  • 科学计算器(Scientific):函数定义、数值表格对照与科学运算
插入的图片自动内嵌封装于 .ggb 包内;支持导出 .ggb、.png、.svg、.pdf、.stl(3D 打印)及直接打印
MindMap 思维导图 .smm
  • 6 种专业结构:思维导图、逻辑结构图、目录组织图、组织结构图、时间轴、鱼骨图,支持在新建或编辑时自由切换
  • 丰富节点元素:自由节点、节点富文本、LaTeX 数学公式、节点图标/贴纸、超链接、关联线、概要节点、外框、备注与自定义标签
  • 高效编辑辅助:大纲视图双向同步编辑、节点搜索与批量替换、直观便捷的快捷键面板
  • 智能系统导入:原生对接系统文件选择器,限制并支持导入 .xmind、.md、.smm、.json、.mind 格式;导入时自动在当前选定分区新建独立文件(自动防重名递增),导入完成立即自动打开
支持导出多种通用格式及直接打印
KDBX 加密密码库 .kdbx KeePass 兼容加密密码库,支持创建与解锁、分组、标签、历史版本、自定义字段、附件、回收站、批量导入导出与主密码重置;内置 2FA 动态口令计算与识别,以及 SSH / 终端会话一键快捷直连 密钥库由独立主密码加密保护;内置 KDBXWeb 与专业终端工作台,支持在工作区内管理
PDF 阅读与批注引擎 .pdf 页面流式浏览、目录导航、文本选择与搜索;文本高亮与划线、自由手绘涂鸦 (Ink)、添加文字批注、插入图片/图章与电子签名;快捷键原地覆盖保存与暗色主题自适应 100% 离线,修改直接覆写保存源文件,无多余弹窗

KDBX 加密密码库(含 2FA 与 SSH 直连支持)

MarkNotePro 基于 KDBXWeb 集成 KeePass 兼容的 KDBX 密码库能力。每个 .kdbx 文件均以独立主密码加密,密码库内容、附件与历史记录保存于本地文件;支持在工作区内按分组管理密钥条目、标签筛选、附件预览、历史恢复、回收站恢复,以及条目的批量移动和受提取码保护的导入导出。

核心安全与快捷能力

  • 2FA 双因素动态口令(TOTP):
    • 原生支持基于时间的动态口令生成与实时环形倒计时显示。
    • 支持直接扫描导入二维码图片、本地文件选择,或通过剪贴板直接粘贴(Cmd+V / Ctrl+V)屏幕截图自动识别 2FA 密钥。
    • 支持通过文本框批量导入多条 otpauth:// 链接或 Base32 密钥,自动按 issuer 命名并智能去重。
    • 支持一键复制动态口令,并与终端会话交互登录防重放机制无缝打通。
  • SSH / 终端快捷直连与运维管理:
    • 密钥条目原生支持绑定为终端会话(如 SSH、Telnet),保存主机、端口、用户名、密码、私钥与凭据。
    • 在条目列表或详情页工具栏中点击**“直连终端”**图标,即可一键在工作区内打开独立终端标签页发起连接,自动读取密码与 2FA 口令。
    • 内置图形化 SFTP 侧边抽屉文件管理器:支持远程服务器目录树浏览、文件上传/下载、重命名、新建文件(预置常用格式)、快捷编辑与删除二次确认防误触。
    • 原生支持 ZMODEM (rz / sz) 文件上下传协议,终端体验与专业终端工具无异。

MarkNotePro 与 MarkTextPro 的能力对齐

MarkNotePro 与 MarkTextPro 共同基于 KDBXWeb 与终端协议栈打造这套一体化 KDBX 加密密码库与终端直连体系,这是二者共有的核心底层能力:

  • MarkNotePro:将密码库与终端直连纳入“工作区 / 分区组 / 分区 / 文档”的结构化知识管理体系,适合团队知识库、运维笔记与凭据资产的一体化管理。
  • MarkTextPro:在真实文件夹、代码仓库与外部自由文件中直接创建和管理密码库,支持对项目本地凭据的随时加解密与一键直连。

两者在密码库加解密、2FA 动态口令、SSH 终端直连与 SFTP 上的功能实现完全一致。

笔记工作区模型

MarkNotePro 的重点是“稳定的笔记结构”。根目录代表一个笔记工作区,根目录自身不折叠;根目录下展示分区组,分区组下可以继续包含子分区组或分区,分区下保存 Markdown 笔记、Draw.io 绘图、GeoGebra 数学文档、MindMap 思维导图与 KDBX 密码库。

flowchart TD
  Root["笔记工作区根目录"] --> Group["分区组"]
  Group --> SubGroup["子分区组"]
  Group --> Area["分区"]
  SubGroup --> Area2["分区"]
  Area --> Note["Markdown 笔记 (.md)"]
  Area --> Drawio["Draw.io 绘图 (.drawio)"]
  Area --> GGB["GeoGebra 数学文档 (.ggb)"]
  Area --> SMM["MindMap 思维导图 (.smm)"]
  Area --> KDBX["KDBX 加密密码库 (.kdbx)"]
  Area2 --> Note2["Markdown / Draw.io / GeoGebra / MindMap / KDBX"]
  Root --> Attach["Attachments 附件目录"]

  Attach -. "真实存在,但不显示在侧边栏" .-> Hidden["图片与附件资源"]
Loading

工作区规则:

  • 根目录用于承载整个笔记工作区,不作为普通笔记节点折叠。
  • 分区组用于组织分区或子分区组。
  • 分区用于保存 Markdown 笔记(.md)、Draw.io 绘图(.drawio)、GeoGebra 数学文档(.ggb)、MindMap 思维导图(.smm)与 KDBX 密码库(.kdbx)。
  • 附件目录(Attachments)用于保存 Markdown 插入的本地图片等资源,界面中默认隐藏;GeoGebra 与 MindMap 内部插入的图片等媒体资源直接封装在文件内部。
  • 删除分区组、分区、文档时会同步关闭相关已打开标签,避免编辑器继续指向旧路径。
  • 重命名或移动笔记结构时,会同步更新已打开文档的路径指向。

Git 联动

MarkNotePro 把 Git 作为笔记工作区的版本管理能力,而不是额外割裂的工具。你可以在笔记区写作,也可以切换到 Git 区完成提交、拉取、推送和历史查看。

flowchart LR
  Note["笔记区"] -- "点击 Git 按钮" --> Git["Git 区"]
  Git -- "点击笔记按钮" --> Note
  Git -- "选择仓库" --> Confirm{"确认切换仓库?"}
  Confirm -- "确认,并勾选切换笔记工作区" --> Workspace["将笔记工作区切换到当前仓库或子目录"]
  Confirm -- "确认,但不切换笔记工作区" --> GitOnly["仅切换 Git 仓库"]
  Workspace --> Reload["关闭已打开笔记并重载工作区"]
  Note -- "重命名根目录" --> Sync["同步更新受管 Git 仓库路径"]
  Sync --> Git
Loading

联动关系:

  • Git 区可以选择仓库,切换前会确认,避免误点。
  • 默认可以勾选“切换笔记工作区”,让笔记工作区跟随当前 Git 仓库。
  • 也可以取消勾选,只切换 Git 仓库,保留当前笔记工作区。
  • 从 Git 区可以把当前仓库根目录或仓库子目录设置为笔记工作区。
  • 如果笔记根目录重命名,MarkNotePro 会同步更新受管 Git 仓库路径,避免 Git 区找不到仓库。
  • 允许 Git 仓库和笔记工作区不是同一个目录,适合更复杂的本地目录规划。

数据安全与 Git 使用建议

MarkNotePro 将 Git 作为知识工作区的核心版本控制与跨设备同步底座。在享受云端备份与协同便利的同时,请务必关注个人数据安全:

  1. 强烈建议使用私有仓库(Private Repository):
    • 知识工作区往往承载着大量个人日常笔记、内部技术方案、业务规划、架构设计与工程图纸等隐私内容。请务必将远程 Git 仓库(如 GitHub、Gitee、GitLab 或自建 Git 服务)设置为私有项目,从源头杜绝个人敏感资料被搜索引擎收录或公开泄露。
  2. 严禁将 KDBX 密码库暴露到公有仓库:
    • 虽然 KDBX 采用业内高标准的对称加密算法(AES-256 / ChaCha20)并由主密码保护,但切勿将 .kdbx 文件推送到任何公开仓库(Public Repository)!
    • 公开暴露密码库意味着攻击者可无限期下载该文件,并在离线环境下利用超级算力进行字典爆破和彩虹表攻击。
    • 若必须使用公开仓库开源部分笔记,请务必将 *.kdbx 加入 .gitignore 规则中严格排除,或使用独立的私有仓库专门存放凭据资产。
  3. 设定极高强度的主密码:
    • KDBX 密码库的坚固程度完全取决于主密码的强度。软件支持 8-16 位大小写字母及数字,强烈建议设置满 16 位混合大小写字母与数字的高强度密码,杜绝使用任何简单弱口令或跨平台重复密码。

截图与演示

查看完整功能展示图

MarkNotePro Git 操作演示
在笔记区和 Git 区之间切换,完成仓库操作与工作区联动
五种警告块样式
五种警告块样式
段落菜单与警告块
段落菜单与警告块
任务状态批量编辑
任务状态批量编辑
列表缩进菜单
列表缩进菜单
插入面板
插入面板
表格工具能力
表格工具能力
表格复制粘贴
表格复制粘贴
Excel 与 MarkNotePro 表格互操作
Excel 与 MarkNotePro 表格互操作
MarkNotePro Git 工作区截图
集成 Git 工作区:查看变更、历史、分支并提交同步

下载安装

platform

国内用户推荐使用百度网盘下载安装包;海外用户可使用 GitHub Releases:

💡 兄弟项目:如果您需要管理真实自由文件夹、代码仓库与外部技术文档,请前往 MarkTextPro 百度网盘下载 或 MarkTextPro Gitee 镜像(GitHub 对应页面:MarkTextPro Releases)。

安装包格式对应:

  • macOS:marknotepro-mac-(arm64|x64)-%version%.dmg
  • Windows:marknotepro-win-(x64|arm64)-%version%-setup.exe
  • Linux:提供 deb、rpm、snap、tar.gz 等构建,具体以网盘或 Release 页面为准。

交流与反馈

刚顺手建了一个 QQ 交流反馈群(与兄弟项目 MarkTextPro 共享),目前群里正处于极简的“群主与自己面面相觑”阶段(成员:1/2000) 🐧。

现在进群不仅妥妥是元老级元勋,还能享受“作者 1 对 1 秒回级催更与答疑”的专属 VIP 待遇:

  • 💡 提想法与脑洞:想要什么新功能、期待什么样的知识库/笔记交互、哪怕再天马行空的想法,随时来提,没准下一个版本就做出来了;
  • 🛠️ 捉虫与吐槽反馈:遇到 Bug、偶发卡顿、排版不顺手,随时发截图,作者第一时间跟进修复;
  • 🤝 交流与共同进步:探讨 Markdown 写作流、思维导图、学术笔记体系,一起把工具打磨得越来越好用!

随时欢迎进群打破沉默,拯救独自对着屏幕沉思的群主~

  • QQ 交流反馈群:871505001
  • 扫码加入(拯救群主):

QQ 交流反馈群

开发

pnpm install
pnpm --filter marknotepro dev

构建桌面端:

pnpm --filter marknotepro build

许可与商业授权

本项目采用 MarkNotePro 非商业使用与商业授权许可协议:

  • 非商业用途免费:个人学习、教学演示、学术研究及个人非商业知识管理可免费下载和使用。
  • 商业用途需授权(严禁未授权商用):未经版权所有人(ScottCheng)事先书面授权,严禁将 MarkNotePro(含源代码、二进制安装包、衍生修改版或内嵌模块)用于任何商业目的(包括但不限于直接或间接售卖、打包进商业产品/SaaS服务、企业商业化部署或抹除署名二次分发)。如需商业使用,请联系作者获取书面商业授权。

内置核心组件协议声明

MarkNotePro 集成了以下开源与第三方核心组件,各组件遵循其对应上游协议(详见 LICENSE):

  • draw.io (diagrams.net):遵循 Apache License 2.0(Copyright (c) 2005-present JGraph Ltd)。
  • GeoGebra:遵循 GeoGebra License(源码遵循 GPLv3,软件、文档与语言资源遵循 GeoGebra Non-Commercial License Agreement / CC BY-NC-SA 3.0,仅限非商业用途免费使用,商业用途须同时遵守 GeoGebra 官方商业授权要求)。
  • simple-mind-map (思绪思维导图):遵循 MIT License(Copyright (c) 2021-2023 The MindMap Team / wanglin2)。
  • KDBXWeb:遵循 MIT License(Copyright (C) 2021-2025 Antelle),其完整许可证文本保留在 packages/desktop/src/kdbxWebApp/kdbxweb/LICENSE。
  • Tabby:遵循 MIT License(Copyright (c) 2017-present Eugenia Kim (Eugeny))。MarkNotePro 的终端会话与色盘配置参考其开源实现。
  • PDF.js:遵循 Apache License 2.0(Copyright 2024 Mozilla Foundation),其完整许可证文本保留在 packages/desktop/src/pdfWebApp/pdfjs/LICENSE。
  • GitHub Desktop:遵循 MIT License(Copyright (c) GitHub, Inc.)。
  • MarkText & Muya:遵循 MIT License(Copyright (c) 2017-present Luo Ran & MarkText Contributors)。

About

本地优先的结构化 Markdown 笔记与知识工作台。原生集成 Git 版本控制、Draw.io 绘图、GeoGebra 建模、思维导图、KDBX 密码库(含 2FA & SSH 直连)及 PDF 专业批注。| Local-first structured Markdown notes & knowledge base with Git, Draw.io, GeoGebra, MindMap, KDBX & PDF.

Topics

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages