VNote：跨平台开源笔记平台

项目简介

VNote 是一款基于 Qt 的免费开源笔记应用，把笔记管理与编辑体验结合起来，支持多种文档格式。使用 C++ 开发，采用 GNU LGPLv3 许可证。

VNote 可运行在 Linux、Windows 和 macOS 上，要求 Qt 6.9+；Qt 5.15 与 Windows 7 已不再受支持。

主要功能

VNote 不只是一款 Markdown 编辑器，目前支持以下格式：

• Markdown（.md、.mkd、.rmd、.markdown）：编写、编辑并预览 Markdown 笔记
• Typst（.typst）：使用原生 Typst 编辑器编写排版文档，并实时预览 PDF
• 纯文本与源码（.txt、.log、.py、.cpp、.js、.json、.yaml 等）：编辑文本笔记、日志、代码与配置文件
• 思维导图（.mmm、.emind）：通过原生思维导图编辑器创建与编辑
• PDF（.pdf）：使用内置阅读器阅读 PDF 文档

结合仓库话题，还涉及数学公式（MathJax）、Vim 编辑模式等编辑能力。

安装与使用

稳定版可在 最新发布页 或 Gitee 发布页 下载；master 分支的持续构建位于 Continuous Build。

更多使用文档见 VNote 主页。

从源码构建的主要前提：

• Git、CMake 3.21+、Ninja、Python 3 和 C++20 编译器
• Qt 6.9+ 开发包，含 Core5Compat、SVG、WebChannel、WebEngineWidgets、PDF、LinguistTools 及对应的 Qt Gui 私有头文件
• Rustup 及 rust-toolchain.toml 中锁定的 Rust 版本（当前为 1.99.0），用于构建原生 Typst 后端

克隆仓库后先运行初始化脚本：

bash scripts/init.sh

Windows 下使用 scripts\init.cmd。该脚本会初始化并更新 git 子模块，并安装使用 clang-format 的 pre-commit 钩子。

Typst 后端由 CMake 将锁定的 Rust 依赖构建成 vtextedit_typst 共享库，无需单独安装 typst CLI 或 Tinymist；首次构建需要联网拉取依赖。

在 Qt Creator 中打开根目录的 CMakeLists.txt，选择与 Qt 和编译器架构匹配的 kit，构建 vnote 与 lrelease 目标即可。使用自定义 Cargo 安装位置时，需设置 CMake 变量 -DVTEXTEDIT_CARGO_EXECUTABLE:FILEPATH=... 指向 cargo 可执行文件。

注意事项

• Typst 在 VNote 内的受控后台线程中运行；超时会丢弃结果但无法强制终止原生调用，关闭时需等待正在进行的调用返回。该共享库是启动必需项，原生编译器故障可能影响 VNote。
• 启动第二个 VNote 进程时，--no-single-instance 会跳过锁与 IPC，但不会隔离用户数据。
• 内置第三方图标集（Lucide、IconPark）及其许可证声明记录在 THIRD-PARTY-NOTICES.md 中。

本作品整理自 GitHub 开源项目 vnotex/vnote，原作者 @vnotex，许可证 LGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。