MarkNotePro

Product Positioning

MarkNotePro is a local-first structured knowledge management and multimodal creation workbench. Centered around structured note workspaces, it organizes documents via section groups and sections on the left, while natively integrating Markdown, Draw.io architectural diagrams, GeoGebra mathematical modeling, MindMap mind mapping, and professional PDF reading & annotation on the right, along with lightweight editing for plain text (.txt, .json, etc.). It also features a built-in KDBX encrypted keystore with 2FA TOTP and SSH/terminal direct connection (requiring keystore establishment, launching sessions directly via entries with automated 2FA verification), seamlessly coupled with Git for version control, commits, and remote synchronization.

Ideal for scenarios such as:

• Managing personal notes, technical architecture diagrams, mathematical/engineering derivations, mind maps, PDF research annotations, server credentials, and long-term knowledge bases within a single local directory.
• Using open, universal local file formats (.md, .drawio, .ggb, .smm, .kdbx, .pdf) to retain complete data ownership without vendor cloud lock-in.
• Creating and editing Draw.io diagrams, GeoGebra models, MindMaps, and annotating PDFs (highlighter, ink doodles, comments, stamps, signatures, in-place overwrite saving) directly in the workspace, 100% offline.
• Synchronizing knowledge repositories via GitHub, Gitee, GitLab, or self-hosted Git services across multiple computers with lossless version history, commits, and rollbacks.
• Maintaining clean, structured knowledge without clutter from unrelated project directories.

Product Selection

MarkNotePro and MarkTextPro are two independent, complementary products:

• MarkNotePro: Local structured note-taking & multimodal knowledge workbench. Emphasizes note workspaces, section groups, sections, and structured document hierarchies. Natively integrates Markdown, Draw.io, GeoGebra, MindMap, KDBX encrypted keystore (2FA TOTP & SSH direct connect), and PDF reading & annotation, tailored for long-term notes, systematic knowledge bases, and local credential management.
• MarkTextPro: Local free file & project multimodal workspace manager. Emphasizes open file systems, arbitrary folder structures, standalone external files, and code project collaboration. Natively integrates Markdown, Draw.io, GeoGebra, MindMap, KDBX encrypted keystore (2FA TOTP & SSH direct connect), and PDF reading & annotation, tailored for code repositories, external tech docs, and flexible editing.

Related Addresses:

• MarkNotePro (Structured local notes & multimodal knowledge workbench):
  • Baidu Netdisk Download (Recommended in China): https://pan.baidu.com/s/17s0JYmzCbqhq2AHpKa2YAA?pwd=dec2
  • GitHub Official Releases: https://github.com/scott20201225/marknote-pro/releases/latest
  • GitHub Repository: https://github.com/scott20201225/marknote-pro
  • Gitee Mirror: https://gitee.com/cmflovekm/marknote-pro
• MarkTextPro (Free file & project multimodal workspace):
  • Baidu Netdisk Download (Recommended in China): https://pan.baidu.com/s/1UVWciYMIAZmI6y-H9KUuNQ?pwd=ddun
  • GitHub Official Releases: https://github.com/scott20201225/marktext-pro/releases/latest
  • GitHub Repository: https://github.com/scott20201225/marktext-pro
  • Gitee Mirror: https://gitee.com/cmflovekm/marktext-pro

Both integrate a Git workspace for version management, remote synchronization, and multi-device collaboration. Your choice depends on whether you need a "structured multimodal note workbench" or a "free multimodal project file manager".

Comparison of the same project displayed in both products: MarkNotePro only displays directories and documents conforming to note standards (.md / .drawio / .ggb / .smm / .kdbx / .pdf), converging them into Section Groups / Sections / Notes; MarkTextPro displays the full, authentic file system hierarchy.

MarkNotePro: Displays only structured note directories and knowledge documents

MarkTextPro: Displays authentic, complete file system hierarchy

Selection Guide:

Core Capabilities

• Structured Knowledge Base Management: Organize knowledge via Notebook Workspaces, Section Groups, and Sections; manage Markdown notes, Draw.io diagrams, GeoGebra math models, MindMaps, KDBX keystores, and PDF documents uniformly.
• External Document Quick Editing: Open standalone .md, .drawio, .ggb, .smm, .kdbx, .pdf, .txt, .json files outside the workspace for preview, editing, annotation, and management.
• Lightweight Plain Text & Config Editing: Natively open and edit common plain text and configuration files such as .txt and .json with in-place saving.
• Multi-Tab & Multi-Type Cooperative Editing: Open, switch smoothly among, and preserve active sessions for multiple Markdown notes, Draw.io diagrams, GeoGebra calculations, MindMaps, KDBX keystores, text files, and PDF annotations simultaneously.
• Built-in Professional PDF Reading & Annotation Engine: Offline integration of Mozilla PDF.js full-featured engine with streaming reading, outline navigation, thumbnails, multi-language full-text search, page rotation, and adaptive scaling; comprehensive annotation tools including text highlighting (multi-color and opacity control), underline/strikethrough, freehand drawing (Ink), text comments, image/stamp insertion, and digital signatures; in-place file overwrite via Cmd+S / Ctrl+S without popup prompts, precise dirty-state tracking, and dark/light theme adaptation.
• Built-in Draw.io Professional Diagram Engine: Offline integration of the complete Draw.io editor for creating, editing, and auto-saving .drawio files, with export support for PNG, JPEG, SVG, PDF, HTML, XML, etc.
• Built-in GeoGebra Mathematical & Geometric Suite: Offline integration of the official GeoGebra engine supporting six modes: Graphing, Geometry, 3D Calculator, CAS (Computer Algebra System), Probability, and Scientific Calculator, with export to .ggb, .png, .svg, .pdf, .stl (3D printing), and direct printing.
• Built-in MindMap Professional Mind Mapping Engine: Offline integration of a full-featured mind mapping workbench supporting 6 classic structures: Mind Map, Logical Structure, Organization Structure, Catalog Organization, Timeline, and Fishbone Diagram; supports rich-text nodes, LaTeX math formulas, node icons/stickers, hyperlinks, associative lines, summary nodes, outer frames, notes, and tags; outline view sync, import of XMind / Markdown / .smm, and export to PNG, SVG, PDF, Markdown, JSON, and system printing.
• Built-in KDBX Encrypted Keystore (with 2FA & SSH Direct Connect): KeePass-compatible .kdbx keystores built on KDBXWeb; supports groups, entries, custom fields, tags, attachments, history, recycle bin, password reset, and encrypted import/export. Deeply integrates TOTP 2FA Dynamic Codes (QR code scanning, clipboard screenshot pasting, URI batch import, real-time countdown, anti-replay) and SSH / Terminal Direct Connection (requires establishing a keystore, launching sessions directly from entries with automated 2FA verification, graphical SFTP file manager drawer, and ZMODEM transfer).
• WYSIWYG Markdown Editing: Headings, lists, task lists, tables, blockquotes, code blocks, math formulas, Mermaid diagrams, warning callouts, and common Markdown formatting.
• Enhanced Tables: Bulk table editing, copy-pasting, and interoperability with Excel.
• Workspace Attachments & Self-Contained Assets: When Markdown resides within a workspace, local images copy to the workspace attachment directory with relative paths; images in GeoGebra and MindMap embed self-contained within documents without losing cross-platform links.
• Internal Link Jumping & Path Copying: One-click copying of document relative paths or Markdown links from the sidebar for fast cross-document linking.
• Clean Sidebar Experience: Automatically filters out .git, .idea, .vscode, node_modules, and irrelevant project directories, keeping only knowledge documents visible.
• Integrated Git Workspace: Built-in Git interface supporting repository adding, cloning, diff viewing, commit, branch management, pull, push, and remote sync.

Built-in Creation & Security Engines: Draw.io, GeoGebra, MindMap, KDBX & PDF

In addition to Markdown writing, MarkNotePro integrates engineering diagrams, STEM mathematical modeling, mind mapping, and professional PDF annotation within a single structured workspace. All engines are bundled locally with the client and are 100% available offline without relying on external web services or cloud accounts:

KDBX Encrypted Keystore (with 2FA & SSH Direct Connect)

MarkNotePro integrates KeePass-compatible KDBX keystore capabilities based on KDBXWeb. Each .kdbx file is encrypted with an independent master password, storing database contents, attachments, and history locally; manage secret entries within structured notes and knowledge workspaces.

Core Security & Convenience Features

• 2FA Two-Factor Authentication (TOTP):
  • Native time-based one-time password generation with real-time circular countdown.
  • Scan QR code images, import local files, or paste screenshots directly (Cmd+V / Ctrl+V) for automated 2FA secret recognition.
  • Batch import otpauth:// URIs or Base32 secret keys via text box with intelligent deduplication.
  • One-click copy of dynamic tokens, seamlessly integrated with terminal login anti-replay mechanisms.
• SSH / Terminal Direct Connection & Ops Management:
  • Bind secret entries as terminal sessions (SSH, Telnet) saving host, port, username, password, and private keys.
  • Click the "Connect Terminal" icon on any entry to launch an independent terminal tab within the workspace, automatically reading credentials and 2FA tokens.
  • Built-in graphical SFTP Drawer File Manager: browse remote server directory trees, upload/download files, rename, create files, edit quickly, and confirm deletions safely.
  • Native ZMODEM (rz / sz) file transfer protocol support.

Note Workspace Model

MarkNotePro organizes knowledge via structured notebook workspaces:

flowchart TD
  Workspace["Note Workspace (Root Directory)"] --> Group["Section Group (GROUP_xxx)"]
  Group --> Section["Section (AREA_xxx)"]
  Section --> Note["Markdown Note (.md)"]
  Section --> Drawio["Draw.io Diagram (.drawio)"]
  Section --> GGB["GeoGebra Document (.ggb)"]
  Section --> MindMap["MindMap Mind Map (.smm)"]
  Section --> KDBX["KDBX Keystore (.kdbx)"]
  Section --> PDF["PDF Document (.pdf)"]
  Section --> Attach["Attachments Directory (.attachments)"]

Workspace Rules:

• Root Directory: The notebook workspace root, corresponding to a Git repository.
• Section Groups (GROUP_*): Top-level knowledge classifications (e.g., Tech Stack, Projects, Daily Life).
• Sections (AREA_*): Specific subject classifications (e.g., Architecture, Database, Frontend).
• Supported Documents: .md, .drawio, .ggb, .smm, .kdbx, .pdf.
• Attachments (.attachments): Dedicated directory per section for images and media assets.

Git Integration

MarkNotePro uses Git as the synchronization and version control foundation for the note workspace:

flowchart LR
  Editor["Note Editor"] -- "Click Git Button" --> Git["Git Area"]
  Git -- "Click Edit Button" --> Editor
  Git -- "Select Repository" --> Confirm{"Confirm Switch Repository?"}
  Confirm -- "Confirm & Check Switch Workspace" --> Workspace["Switch Note Workspace to Selected Repository"]
  Confirm -- "Confirm without Switching Workspace" --> GitOnly["Switch Git Repository Only"]
  Workspace --> Reload["Reload Workspace & Refresh Tree"]

Security & Git Guidelines

1. Strongly Recommend Private Repositories:
   • Note workspaces usually contain personal journals, technical architecture, internal server credentials, and private memos. Please set remote Git repositories (GitHub, Gitee, GitLab) to Private to prevent accidental disclosure or search engine indexing.
2. Never Expose KDBX Keystores to Public Repositories:
   • Even with strong cryptography and master passwords, never push .kdbx files to public repositories! Add *.kdbx to .gitignore if managing an open-source repository.
3. Use Strong Master Passwords:
   • Keystore security depends entirely on master password complexity. The software supports 8-16 alphanumeric characters; we strongly recommend setting a full 16-character mixed-case alphanumeric password.

Screenshots & Demos

View Full Showcase Image

Seamless switching between Editor and Git areas for repository operations and workspace linkage
Five Warning Callout Styles	Paragraph Menu & Warning Callouts
Bulk Task Status Editing	List Indent Context Menu
Insert Palette
Table Toolkit Capabilities
Table Copy & Paste	Excel & MarkNotePro Interoperability
Integrated Git Workspace: View diffs, history, branches, and commit & push

Download & Installation

Users in mainland China can download installers via Baidu Netdisk; international users can download directly from GitHub Releases:

• Baidu Netdisk Download (Recommended in China): https://pan.baidu.com/s/17s0JYmzCbqhq2AHpKa2YAA?pwd=dec2
• GitHub Official Releases Download: https://github.com/scott20201225/marknote-pro/releases/latest
• Gitee Mirror Repository: https://gitee.com/cmflovekm/marknote-pro

💡 Sibling Project: If you need to manage authentic local folders, code repositories, and external tech documents, visit MarkTextPro Baidu Netdisk Download or MarkTextPro Gitee Mirror (GitHub page: MarkTextPro Releases).

Package Formats:

• macOS: marknotepro-mac-(arm64|x64)-%version%.dmg
• Windows: marknotepro-win-(x64|arm64)-%version%-setup.exe
• Linux: deb, rpm, snap, tar.gz packages (see Baidu Netdisk or Release page).

Development

pnpm install
pnpm --filter marknotepro dev

Build desktop client:

pnpm --filter marknotepro build

License & Commercial Authorization

This project is licensed under the MarkNotePro Non-Commercial Use and Commercial Authorization License:

• Free for Non-Commercial Use: Personal study, educational demonstration, academic research, and personal tech/document management may download and use the software free of charge.
• Commercial Use Requires Authorization (Unauthorized commercial use strictly prohibited): Without prior written authorization from the copyright holder (ScottCheng), using MarkNotePro (including source code, binary installers, derivative modifications, or embedded modules) for any commercial purpose (including but not limited to direct or indirect sales, bundling into commercial products/SaaS services, enterprise commercial deployment, or redistribution with removed attribution) is strictly prohibited. For commercial licensing, contact the author.

Third-Party Component Licenses

MarkNotePro integrates the following open-source and third-party core components under their respective upstream licenses (see LICENSE):

• draw.io (diagrams.net): Licensed under Apache License 2.0 (Copyright (c) 2005-present JGraph Ltd).
• GeoGebra: Licensed under GeoGebra License (Source code under GPLv3; software, documentation, and language assets under GeoGebra Non-Commercial License Agreement / CC BY-NC-SA 3.0; free for non-commercial use only).
• simple-mind-map: Licensed under MIT License (Copyright (c) 2021-2023 The MindMap Team / wanglin2).
• KDBXWeb: Licensed under MIT License (Copyright (C) 2021-2025 Antelle).
• PDF.js: Licensed under Apache License 2.0 (Copyright 2024 Mozilla Foundation).
• Tabby: Licensed under MIT License (Copyright (c) 2017-present Eugenia Kim (Eugeny)).
• GitHub Desktop: Licensed under MIT License (Copyright (c) GitHub, Inc.).
• MarkText & Muya: Licensed under MIT License (Copyright (c) 2017-present Luo Ran & MarkText Contributors).