vnote

vnotexLGPL-3.0活跃维护

基于 C++ 的本地笔记平台,主打 Markdown、思维导图、Typst 和纯文本编辑,启动和响应速度接近原生应用,适合想要 Typora 替代品又在意性能的用户。

A pleasant note-taking platform with native speed, majoring in Markdown, MindMap, Typst, and plain text.

v4.14.1发布于 2026-11-08 15:41 UTC13,038star +4 / 7 天1,297fork同步于 2026-11-10 05:27 UTC

怎么上手

README 里没有找到可直接复制的安装命令

README 里没有找到可直接复制的安装命令,请到 README 或官方文档查看安装方式。

硬件要求

README 没有说明硬件要求。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

这个项目的说明还在生成中,先参考下面「最近发版」和 README。

最近发版

5 个版本v4.14.1
  1. v4.14.1最新正式版2026-11-08 · 2026-11-08 15:41 UTC

    v4.14.1

    A refinement release with source-linked outline editing, steadier Markdown previews and smoother navigation on top of VNote 4.14.0:

    • Outlines and mind maps
      • Edit Markdown and safely mapped Typst source headings through toolbar mind-map previews: rename topics, add children or siblings, and move sections with confirmation and paired Undo/Redo
      • Apply accepted edits directly to the source and reuse its Auto Save, Backup File or None policy; closing a rejected topic draft offers Discard or Cancel without discarding changes already applied to the source
      • Keep read-only sources, PDF outlines and unsupported mappings navigation-only; restrict generated maps to basic topic and structure editing, and require reopening after independent source changes
      • Extend Outline panel and popup reordering to ordinary mind maps and safely mapped Typst sections, preserving hierarchy, section content and undo history
      • Keep outline mind-map previews open and focused when navigating to source headings, avoid duplicate section numbers, and preserve newly added topics while source updates settle
    • Editing and Markdown
      • Keep concealed Markdown formatting markers hidden while editing, with marker-skipping cursor movement; preserve link reveal-on-entry and the existing concealment toggles
      • Ask once when opening a Markdown view whether to conceal or show Markdown markers, remember the choice, and point to the toolbar menu for later changes
      • Update vtextedit to improve folded source headers and preview placement, preserve the viewport during passive layout and unfolding, and stabilize Markdown concealment during IME composition
      • Prevent in-place preview staging flashes in the Markdown reader and fix reader navigation restoration and view teardown lifetime
    • Interface and reliability
      • Move United Entry's Expand All preference into its own Settings page while retaining the saved choice
      • Select VNote Tips using the resolved application language rather than the regional locale
      • Keep the existing theme overflow indicators readable on narrow view-window toolbars instead of clipping them to a gray square
      • Attach document views before showing detached windows to avoid an empty first frame
      • Update vxcore with desktop-validated mobile-branch integration, including trusted-root alias handling and private long-path fixture fixes
      • Fix widget CI linkage by testing production view-window implementations
    • Translations: Simplified Chinese (zh_CN) and Japanese (ja) catalogs updated

    v4.14.1

    本次改进版本基于 VNote 4.14.0,带来源文档联动的大纲编辑、更稳定的 Markdown 预览及更流畅的导航体验:

    • 大纲与思维导图
      • 通过工具栏思维导图预览编辑 Markdown 及具有可靠源映射的 Typst 标题:重命名主题、添加子节点或同级节点,并在确认后移动章节,支持与源文档配对的撤销/重做
      • 将接受的编辑直接应用到源文档,并沿用其自动保存、备份文件或不保存策略;关闭无法应用的主题草稿时可选择丢弃或取消,不会丢弃已应用到源文档的更改
      • 只读源文档、PDF 大纲及不支持的映射仅允许导航;生成的思维导图仅允许基本的主题及结构编辑,源文档发生独立更改后需重新打开预览
      • 将大纲面板及弹出窗口中的排序功能扩展到普通思维导图和具有可靠源映射的 Typst 章节,保留层级、章节内容及撤销历史
      • 导航到源标题时保持大纲思维导图预览打开且保有焦点,避免重复章节编号,并在源更新完成前保留新添加的主题
    • 编辑与 Markdown
      • 编辑时保持 Markdown 格式标记隐藏,光标移动会跳过这些标记;保留进入链接时显示标记的行为及现有隐藏开关
      • 首次打开 Markdown 视图时询问隐藏还是显示 Markdown 标记,记住选择,并提示以后可通过工具栏菜单更改
      • 更新 vtextedit,改进折叠后的源标题及预览位置,在被动布局及展开时保持视口稳定,并改善输入法组合输入期间 Markdown 标记隐藏的稳定性
      • 防止 Markdown 阅读器中原地预览准备阶段的闪烁,修复阅读导航恢复及视图销毁生命周期问题
    • 界面与可靠性
      • 将统一入口的“全部展开”偏好移至独立的设置页面,同时保留已保存的选择
      • 根据实际使用的应用语言而非区域设置选择 VNote 提示
      • 在较窄的视图窗口工具栏中保持现有主题的溢出指示器清晰可见,不再裁剪为灰色方块
      • 在显示独立窗口前先附加文档视图,避免首帧空白
      • 更新 vxcore,整合经桌面验证的移动端分支,包括可信根目录别名处理及私有长路径测试夹具修复
      • 通过测试实际的视图窗口实现修复控件 CI 链接问题
    • 翻译:更新简体中文(zh_CN)及日语(ja)翻译
  2. v4.14.02026-11-05 · 2026-11-05 14:15 UTC
    查看更新说明

    v4.14.0

    A feature release with scoped HTTP automation, richer Markdown paste and smoother navigation on top of VNote 4.13.0:

    • HTTP automation and security
      • Add an opt-in, loopback-only HTTP API for local agents and administrator-managed HTTPS reverse proxies, with notebook-scoped tokens and separate read, live-read, write and trash permissions
      • List notes, read saved or live content, search, and conditionally create, edit, append, rename or trash notes without overwriting dirty editors or exposing protected notes
      • Require reversible trash without falling back to permanent deletion, preserve save/sync coordination, and drain pending operations during shutdown
      • Manage tokens in Settings with a dedicated issuance dialog, notebook and permission selection, expiry presets or Never, a 90-day default, one-time Copy and immediate revocation
      • Store listener settings in local session configuration and Windows token verifiers in the local profile, preserving portable isolation and owner-only access, including elevated accounts
      • Audit requests, rejected connections and asynchronous mutation outcomes with privacy-safe structured records and shared request IDs; omit note paths and raw exception details from create/rename diagnostics
    • Editing and Markdown
      • Preserve KaTeX and MathML formulas when parsing HTML to Markdown and pasting: prefer annotated TeX, recover supported MathML when annotations are stripped, and retain inline/display math and labeled underbraces without duplicate rendered text
      • Avoid unnecessary escapes in leading numbered headings while preserving literal backslashes and paragraph list protection
      • Prevent concealed Markdown markers from blinking during unrelated typing by retaining and remapping the last parsed concealment until fresh results arrive
      • Add Collapse and Expand below Export in read-mode code-block context menus
      • Restore warm Markdown page visibility before rendering when switching tabs, avoiding blank WebEngine frames without keeping inactive pages active
    • Navigation and mind maps
      • Search file names across notebooks with ordinary United Entry input; require the explicit > prefix for commands, show command discovery for empty input, and enable Expand All by default while retaining saved preferences
      • Restore focus to the source content after closing previews, including the mind-map canvas
      • Refine mind-map field menus, shortcut editors and node-anchored popups, improve node icons, and place the nonempty note indicator before the hyperlink indicator
      • Open files classified as Others with the system application instead of the plaintext editor, retain inferred text/image viewers, and skip unsupported restored tabs without launching external applications
    • Interface and reliability
      • Enlarge Sort Folders and Sort Notes to 800 × 600 by default and select the triggering folder or note when present
      • Reserve persistent editor status rows below the content and prevent Windows status/link-preview overlays from promoting entire tab containers to native windows
      • Stack notification action buttons vertically, unify Settings card surfaces and action alignment, restore complete theme button borders, and clarify editor toolbar option hints
      • Select bundled release-note language from the loaded UI translation rather than the regional locale
      • Improve native CI credential, popup and notification-layout checks, preserve first-failure diagnostics, and recover transient macOS package-mount and WebEngine-shutdown failures
    • Translations: Simplified Chinese (zh_CN), Japanese (ja) and Korean (ko) catalogs updated

    v4.14.0

    本次功能版本基于 VNote 4.13.0,带来按权限限定的 HTTP 自动化、更完善的 Markdown 粘贴及更流畅的导航体验:

    • HTTP 自动化与安全
      • 新增默认关闭、仅监听回环地址的 HTTP API,供本地自动化客户端及管理员配置的 HTTPS 反向代理使用;令牌按笔记本授权,分别控制读取、实时读取、写入和移入回收站权限
      • 支持列出笔记、读取已保存或实时内容、搜索,以及有条件地创建、编辑、追加、重命名或移入回收站,不覆盖编辑器中的未保存更改,也不暴露受保护笔记
  3. v4.13.02026-11-02 · 2026-11-02 09:33 UTC
    查看更新说明

    v4.13.0

    A feature release with outline mind maps, editable node-note previews, source-aware exports and refined editing on top of VNote 4.12.0:

    • Mind maps and navigation
      • Open source-bound mind-map previews of document outlines, use a sole leading H1 as the central topic, and apply automatic branch colors
      • Focus outline previews on the current heading and click nodes to navigate to their original source headings; reopen the preview after the outline changes
      • Edit mind-map node notes in source-bound plain-text previews with normal autosave; keep these previews attached to their source rather than promoting them to independent tabs
      • Compact node icon rows and fix the clipped Tags label when keyboard shortcut underlines are visible
      • Add Open Link above Copy Link in mind-map URL context menus, including read-only maps
      • Always open context-menu links in a new tab across Markdown, Typst and mind maps, regardless of the new-tab preference
      • Allow Never Ask for local-file and custom-protocol link warnings and share the saved opt-out across warning paths
    • Editing and Markdown
      • Enable Markdown marker concealment by default and move long-link concealment into the editor menu, with independent persisted preferences and existing opt-outs preserved
      • Fix closing Markdown heading-marker highlighting and preserve syntax backgrounds on the cursor line; update vtextedit and both vendored cmark copies
      • Preserve preformatted and class-hinted HTML code blocks when pasting Markdown, including indentation, language hints and embedded fences, without copying controls or swallowing surrounding prose
      • Update bundled Turndown to 7.2.4 for improved link escaping and ordered-list indentation while retaining VNote's custom paste rules
      • Add Ctrl+W and Ctrl+U editing shortcuts to plain-text fields; assign the default Ctrl+8 and Ctrl+9 shortcuts to unchecked and checked task lists instead of unordered and ordered lists
      • Rename Toggle In-Place Preview to In-Place Preview
    • Export
      • Make export targets and options follow the selected source types, including native Typst and MindMap source output; reject incompatible selections before creating output
      • Export Typst through its native compiler to HTML and PDF, preserving authored page layouts; copy internal relative images for native source exports and report unbundled imports or dynamic references
      • Add a shared, editable web/css/export.css stylesheet for HTML and HTML-based PDF/Custom exports; preserve user styles across upgrades and leave native Typst PDF unchanged
      • Simplify option labels and explain when custom commands use original disk files rather than the current buffer snapshot
    • Notebooks and interface
      • Support drag-and-drop changes to tag parent hierarchies
      • Replace the node Mark dialog with separate Text and Background color menus using the existing 12 colors and PDF-style swatches; Auto clears only the selected override
      • Keep Chinese IME input in toolbar popup fields on Windows and macOS, with frameless dismissal, overflow access, fullscreen focus and focus restoration after owned dialogs
      • Move the raw-notebook action to the explorer title bar, inset editor status controls within their frame, and throttle tree-column remeasurement during resizing
      • Use Documents/vnote_notebook for new first-run notebooks and manually added quick-note schemes without migrating existing folders or saved paths
      • Reopen an existing default notebook during first-run setup without replacing its contents on failure; add all-in-one.md and pin it to Quick Access when the list is empty
      • Add the default Quick Note in Current Notebook scheme using Quick Notes/quick_note_%da%.md; existing installations are not migrated, and the bundled Chinese welcome note is named Welcome_zh_CN.md
      • Expand localized VNote Tips from 12 to 64 with Markdown, navigation, image, PDF, mind-map, export and
  4. v4.12.02026-10-29 · 2026-10-29 09:27 UTC
    查看更新说明

    A feature release with editable link previews, native Markdown rendering, Typst math and stronger security on top of VNote 4.11.0:

    • Link previews and navigation
      • Preview supported file links in editable overlays without leaving the current note; use Open Link to open normally and dismiss previews from the source backdrop
      • Open preview tabs in their source workspace without reopening editors or losing drafts and Undo history; replacing duplicate tabs honors Save, Discard and Cancel
      • Require Ctrl+click to open links in the Markdown editor so ordinary clicks only position the cursor
      • Put Open Link before Copy Link in Markdown reader link menus and hide unrelated Edit and Export actions on links and images
      • Allow file-open settings to target an existing main or detached split, preserving background selection and reporting unavailable destinations without rerouting
    • Markdown and Typst
      • Render Markdown natively with cmark in Read mode, live previews and WebEngine exports, reusing current editor parse trees while preserving wikilinks, tasks, alerts and the table of contents
      • Remove emoji shortcode and emoticon expansion; authored Unicode emoji remain unchanged
      • Add Typst as an optional Markdown math renderer, including authorized encrypted notes, in-place previews, self-contained HTML/PDF exports and cross-copy; KaTeX remains the default, and selecting Typst uses Typst syntax inside the existing dollar delimiters
      • Render fenced typst blocks as self-contained markup independently of the math setting, preserving authored page layouts and multi-page output in previews, exports and cross-copy
      • Align Markdown Typst blocks with surrounding content by removing their default page margin; explicit margins and standalone document layouts remain unchanged
      • Replace the Typst helper process with a bundled shared runtime and bounded background workers, retaining previews and exports with orderly shutdown
      • Discover installed system fonts to fix missing Chinese glyphs in Typst previews and exports, while retaining configured-font precedence
      • Match Typst editor fonts and preview backgrounds to the active theme, including Typst-specific overrides; authored document styles take precedence and theme preview colors do not alter exports
      • Remove informational overlays from the Typst PDF preview while retaining errors and compiler diagnostics; clean obsolete Typst images when document closure is accepted
      • Keep presentation requests alive across delayed reader focus and native window reconstruction, and prevent stale PDF state or WebChannel rebinding from disrupting replacement notes
      • Restrict editor section numbering to ATX headings rather than numbering Setext headings
    • Security and tasks
      • Fix Markdown raw-HTML URL sanitizer bypasses by validating browser-decoded URLs before installing content in readers, live previews and exports
      • Add a searchable Protect Markdown from XSS setting under Markdown Editor → Read; filtering remains mandatory for encrypted notes
      • Prevent task command injection through filenames, selected text and other variables: shell commands and options must be static, variable values belong in literal args, and values are no longer recursively expanded
      • Migrate the bundled Git commit task and provide guidance for custom tasks; shell tasks with arguments require Bash or PowerShell, otherwise use type: process
      • Share external-link warnings and the Never Ask preference across Markdown, Typst and mind maps while preserving authorization, cancellation, stale-view checks and independent local-file warnings
    • Mind maps and interface
      • Add image context actions to view, copy, copy the source address and resize with Undo support; hide image tooltips that exposed URLs or base64 data
      • Apply mind-map node-properties placement immediately without reopening the editor or losing edits; kee
  5. v4.11.02026-10-22 · 2026-10-22 00:34 UTC
    查看更新说明

    Windows 7 and older Windows 10 are no longer supported from now on!

    A feature release with native Typst editing, reusable note tabs and refined mind-map tools on top of VNote 4.10.0:

    • Typst
      • Create and edit .typst notes with a bundled native compiler, live PDF preview, in-place previews and compiler diagnostics; switch to PDF-only Read mode without losing the source editing session
      • Toggle Live Preview and In-Place Preview independently, search source in Edit mode and PDF text in Read mode, and use page navigation, presentation and shared zoom controls
      • Follow the active theme in the preview, with a per-view Theme Style in Preview toggle; explicit document styles take precedence and exports retain their original styling
      • Insert images, links, attachments and file contents from dialogs, the clipboard and drag-and-drop, keeping local image resources inside the note's Typst project
      • View, copy and safely resize images from source, in-place previews and PDF context menus; open image overlays with zoom and pan, and route local-file links through VNote
      • Navigate compiled headings from Outline without selecting their text, use consistent preview menus in Edit and Read modes, and restore the session cursor without jumping to the end
      • Add a default title.typst template using the filename without its extension, while preserving existing template choices
    • Tabs and performance
      • Add an Always open notes in new tabs setting; disable it to reuse the current tab, or hold Ctrl when activating a note to open a new tab
      • Retain compatible editors, preview resources and zoom/layout preferences across note replacement, with save/comment confirmation and isolation of document history and pending operations
      • Release hidden Markdown web views after a configurable timeout, defaulting to five minutes; returning reloads the current preview without losing unsaved text or Undo history
      • Delay Markdown readers in edit-only mode, share editor JavaScript work across tabs with protected-note isolation, and release obsolete MathJax, menu and Graphviz content when readers change
    • Mind maps
      • Refine balanced layouts with clockwise ordering, add Ctrl+H/J/K/L navigation, show branch-facing expand/collapse controls on hover, and restore canvas keyboard focus after layout changes
      • Use softer theme-derived connectors, outlines and tag borders in the editor and exports; match properties controls and separators to the active theme
      • Exclude neutral colors and Mint from automatic branch colors while preserving existing branch colors and manual choices
      • Add a default title.mmm template using the note title as the central topic, while preserving existing template choices
      • Add Alt+M for the Image property while keeping Alt+I for Icons, align property heading styles, and remove the redundant add-link shortcut and dialog
    • Printing and export
      • Print mind maps from the toolbar menu, fitting the current layout onto one page with vector text, images, links and inline drafts; open Export directly from the empty-canvas context menu
      • Print the rendered Markdown document in Read mode and current source in Edit mode, including selections and live-preview split layouts
      • Produce readable document-style mind-map Markdown exports and align node links with their HTML articles
      • Fix clipped KaTeX fractions in PDF/custom exports and inline math alignment in exports and cross-copy (#2776)
      • Initialize export rendering and syntax styles from the current theme on the first dialog show of each session, retain later choices, and show the notebook name in Current notebook exports
    • Search, themes and interface
      • Add United Entry aliases t/T for tag searches in the current/all notebooks, and N/G for filename/content searches across all notebooks; group aliases by scope
      • Add Undo and Redo toolbar buttons to text and Ma

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    VNote

    CI-Windows CI-Linux CI-MacOS

    简体中文

    Project on Gitee

    A pleasant note-taking platform.

    For more information, please visit VNote's Home Page.

    VNote

    Description

    VNote is a Qt-based, free and open source note-taking application. It combines note management with an excellent editing experience across multiple document formats.

    VNote runs on Linux, Windows, and macOS, and requires Qt 6.9+. Qt 5.15 and Windows 7 are no longer supported.

    Supported formats

    VNote is more than a Markdown editor — these formats are supported today:

    • Markdown (.md, .mkd, .rmd, .markdown): write, edit, and preview Markdown notes
    • Typst (.typst): write and edit typeset documents with the native Typst editor and live PDF preview
    • Plain text and source code (.txt, .log, .py, .cpp, .js, .json, .yaml, and more): edit text notes, logs, code, and configuration files
    • Mind maps (.mmm, .emind): create and edit mind maps with the native mind-map editor
    • PDF (.pdf): read PDF documents with the built-in viewer

    Main

    Downloads

    Continuous builds on master branch could be found at the Continuous Build release.

    Latest stable builds could be found at the latest release or Gitee release

    Supports

    Thank users who donated to VNote!

    Development

    Prerequisites

    • Git, CMake 3.21+, Ninja, Python 3, and a C++20-capable compiler (the syntax indexer uses C++20; VNote uses C++17)
    • Qt 6.9+ development packages, including Core5Compat, SVG, WebChannel, WebEngineWidgets, PDF, LinguistTools, and matching Qt Gui private headers
    • On Windows: Visual Studio's Desktop development with C++ workload and Windows SDK, with a 64-bit MSVC Qt kit (the development setup uses Qt 6.10.3 MSVC2022 64bit)
    • Rustup and the Rust version pinned in rust-toolchain.toml (currently 1.99.0); use the x86_64-pc-windows-msvc host for the Windows kit above
    • Optional: clang-format for the formatting hooks

    Initialize the checkout

    After cloning the repository, run the initialization script to set up your development environment:

    Linux/macOS:

    bash scripts/init.sh
    

    Windows:

    scripts\init.cmd
    

    This script will:

    • Initialize and update all git submodules
    • Install pre-commit hooks for automatic code formatting with clang-format
    • Set up the vtextedit submodule pre-commit hook

    Install the Typst build toolchain

    VNote requires the native Typst backend. Install Rustup first, then install the pinned Rust toolchain. These commands assume Rustup's default installation location.

    Windows (PowerShell, no PATH change required):

    & "$env:USERPROFILE/.cargo/bin/rustup.exe" toolchain install 1.99.0 --profile minimal
    Push-Location libs/vtextedit/tools/typst-backend
    & "$env:USERPROFILE/.cargo/bin/cargo.exe" --version
    & "$env:USERPROFILE/.cargo/bin/rustc.exe" --version
    Pop-Location
    

    Linux/macOS:

    rustup toolchain install 1.99.0 --profile minimal
    (cd libs/vtextedit/tools/typst-backend && cargo --version && rustc --version)
    

    CMake builds the locked Rust dependencies into the vtextedit_typst shared library, linked by VTextEdit and bundled with VNote. No separate typst CLI or Tinymist installation is required. The first build needs network access to fetch dependencies.

    Qt Creator

    1. Open the root CMakeLists.txt and select a kit matching your Qt and compiler architecture. On Windows, select Desktop Qt 6.10.3 MSVC2022 64bit if installed.
    2. Under Projects > Build Settings, use Ninja and separate fresh build directories, such as build-typst-debug and build-typst-release. Do not reuse a stale build cache from another toolchain.
    3. In Initial Configuration, add this Windows CMake parameter for both profiles:
      -DVTEXTEDIT_CARGO_EXECUTABLE:FILEPATH=%{Env:USERPROFILE}/.cargo/bin/cargo.exe
      
      For a custom Cargo installation, use its actual executable path. On Linux/macOS, ensure Cargo is on Qt Creator's build environment PATH, or set the same CMake variable to its executable path. Initial Configuration applies to a new build directory; an already configured directory needs its current CMake configuration updated too.
    4. Add -DVNOTE_BUILD_TESTS:BOOL=ON to the Debug profile if you want the VNote tests. Configure, then build the vnote and lrelease targets; select vnote to run/debug. The Typst shared library is a build dependency, not a separate run target.
    5. Open a .typst note in VNote and check that its preview renders. To smoke-test the Windows library directly from the repository root:
      python scripts/e2e/smoke_typst_package.py --library build-typst-release/src/vtextedit_typst.dll
      

    Typst runs on bounded background threads inside VNote. Timeouts discard results but cannot forcibly stop native calls; shutdown waits for active calls to return. The shared library is required at startup, and native compiler faults can affect VNote.

    For a second VNote process, --no-single-instance skips locking/IPC but does not isolate user data. Follow the isolated GUI smoke recipe when testing with a disposable profile and notes.

    For more development guidelines, see AGENTS.md.

    License

    VNote is licensed under GNU LGPLv3.

    Bundled third-party material and the notices its licenses require — the Lucide (ISC/MIT) and IconPark (Apache-2.0) icon sets — are recorded in THIRD-PARTY-NOTICES.md.