Skip to content
Projects

scott20201225/marktext-pro has 115 GitHub stars and 11 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 15:53 UTC. Last push 2026-11-08.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

集成 Git 的多模态文件编辑管理器与自由工作区。原生支持 Markdown、Draw.io、GeoGebra、思维导图、KDBX 密码库(含 2FA & SSH 直连)与 PDF 专业批注。| Multimodal Markdown editor & Git workspace with Draw.io, GeoGebra, MindMap, KDBX & PDF annotation.

Developer Tools

README_en.md

Original

MarkTextPro

MarkTextPro

Git-Integrated Multimodal Markdown File Editor & Workspace Manager
A lightweight, unconstrained editing and management tool for local directories, external documents, code repositories, and Git projects.
Supports Linux, macOS, and Windows.
简体中文 | English

Product Positioning

MarkTextPro is a Git-integrated multimodal file editor and workspace manager. Preserving native, unrestricted file system directory structures, it is tailored for code repositories and external standalone documents. It natively integrates Markdown editing, Draw.io architectural diagrams, GeoGebra mathematical modeling, MindMap mind mapping, and professional PDF reading & annotation, 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.

Product Selection

MarkTextPro and MarkNotePro are two independent, complementary products. Both natively share Markdown, Draw.io, GeoGebra, MindMap, KDBX encrypted keystore, and professional PDF reading & annotation capabilities. The difference lies in their organizational models: MarkTextPro targets real file system directories, project repositories, and external standalone files; MarkNotePro targets structured knowledge workspaces structured as Notebooks / Section Groups / Sections / Notes.

  • MarkTextPro: Git-integrated multimodal file editor & manager emphasizing unconstrained directory trees, external standalone files, code collaboration, and rapid editing.
  • MarkNotePro: Git-integrated structured note-taking workbench emphasizing workspace notebooks, section groups, sections, document hierarchy, and long-term knowledge management.

Related Addresses:

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

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

MarkNotePro Structured Notes View
MarkNotePro: Displays only structured note directories and knowledge documents
MarkTextPro Authentic File System View
MarkTextPro: Displays authentic, complete file system hierarchy

Selection Guide:

Use Case / Requirement Recommended Product
You primarily work within real folders, code repositories, or frequently edit standalone documents and project READMEs MarkTextPro
You need to create and manage Markdown, Draw.io architecture diagrams, GeoGebra mathematical models, MindMap mind maps, KDBX keystores (with 2FA & SSH), or annotate PDFs directly within arbitrary folders or external paths MarkTextPro
You prefer to retain real file system directory structures without notebook hierarchy constraints MarkTextPro
You need a flexible local multimodal file and project workspace manager MarkTextPro
You want to manage long-term notes, structured knowledge bases, and project materials like a notebook MarkNotePro
You need to author Markdown, draw Draw.io architecture/flowcharts, build GeoGebra models, create MindMaps, or annotate PDFs within structured notes MarkNotePro
You prefer a notebook / section group / section / document hierarchical structure MarkNotePro
You want the sidebar to display only note systems, eliminating clutter from unrelated project files MarkNotePro

Core Capabilities

  • Local Folder Management: Open any folder directly and manage Markdown, Draw.io diagrams, GeoGebra models, MindMaps, KDBX keystores (with 2FA & SSH), common text files, and PDF documents according to real directory structures.
  • External Document Quick Editing: Open standalone .md, .drawio, .ggb, .smm, .kdbx, .pdf, .txt, .json files outside the workspace for fast 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.
  • Noise Directory Filtering: Workspace file tree hides common noise folders by default: .git, .idea, .vscode, .vs, .claude, .codex, node_modules, etc.
  • Integrated Git Workspace: Built-in Git interface supporting repository adding, cloning, diff viewing, commit, branch management, pull, push, and remote sync.
  • Workspace & Git Repository Synchronization: Switch file workspaces directly from Git repositories and synchronize managed Git repository paths upon root directory renaming.

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

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

Creation Engine Extension Supported Modes & Core Features Export & Format Support
Draw.io Diagramming .drawio Flowcharts, architecture diagrams, UML, ER diagrams, network topologies; multi-tab keepalive switching, shortcut saving, and auto-save state sync Export to PNG, JPEG, SVG, PDF, HTML, XML, etc.
GeoGebra Math Suite .ggb
  • Graphing: Function plotting, derivatives/integrals, sliders, value tables, and geometric tools
  • Geometry: Ruler-and-compass constructions, polygons, conics, measurements, transformations
  • 3D Graphing: Space surfaces, solid geometry, vectors, and planes
  • CAS: Symbolic calculus, equation solving, factorization, matrices
  • Probability: Normal/Binomial/Poisson distribution visualization and interval calculation
  • Scientific: Functions, value tables, and calculations
Inserted images embedded in .ggb package; export to .ggb, .png, .svg, .pdf, .stl (3D print), and direct printing
MindMap Mind Mapping .smm
  • 6 Classic Structures: Mind map, logical structure, catalog organization, organization chart, timeline, fishbone diagram
  • Rich Node Elements: Free nodes, rich text, LaTeX formulas, icons, stickers, hyperlinks, associative lines, summary nodes, frames, notes, tags
  • Editing Aids: Two-way outline view sync, node search & replace, keyboard shortcuts panel
  • Smart Import/Export: Import .xmind, .md, .smm, .json, .mind; export PNG, SVG, PDF, Markdown, JSON, and system printing
Export to multiple standard formats and direct printing
KDBX Keystore .kdbx KeePass-compatible encrypted password database with groups, tags, history, custom fields, attachments, recycle bin, bulk import/export, and master password reset; built-in 2FA TOTP and one-click SSH/terminal direct connection Protected by master password; built-in KDBXWeb and terminal workbench, openable in workspace and external paths
PDF Reader & Annotator .pdf Streaming reading, outline navigation, text selection/search; text highlight/underline, freehand drawing (Ink), text annotations, image/stamp insertion, and digital signature; in-place overwrite saving with dark theme adaptation 100% offline, directly overwrites source files without extra prompts

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

MarkTextPro 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, tags, attachment previews, history restores, and recycle bin in arbitrary directories.

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.

File Workspace Model

MarkTextPro's workspace is an authentic local folder. It does not enforce notebook/section hierarchies, respecting local directory structures; manage Markdown, Draw.io, GeoGebra, MindMap, KDBX, and PDF documents within any folder while filtering development noise directories.

flowchart TD
  Root["Workspace Root Directory"] --> Folder["Arbitrary Subfolders"]
  Folder --> Markdown["Markdown Files (.md)"]
  Folder --> Drawio["Draw.io Diagrams (.drawio)"]
  Folder --> GGB["GeoGebra Documents (.ggb)"]
  Folder --> MindMap["MindMap Mind Maps (.smm)"]
  Folder --> KDBX["KDBX Keystores (.kdbx)"]
  Folder --> PDF["PDF Documents (.pdf)"]
  Folder --> Other["Other Plain Files"]
  Root --> Attach["Attachments Directory"]
  Root -. "Hidden by default" .-> Git[".git"]
  Root -. "Hidden by default" .-> IDE[".idea / .vscode / .vs"]
  Root -. "Hidden by default" .-> Agent[".claude / .codex"]
  Root -. "Hidden by default" .-> Deps["node_modules, etc."]

Workspace Rules:

  • Folder and file names mirror the authentic file system.
  • Directly open Markdown, Draw.io (.drawio), GeoGebra (.ggb), MindMap (.smm), KDBX (.kdbx), and PDF (.pdf) files for editing and annotation; other files serve as project context.
  • Cutting, pasting, renaming, or deleting files/folders synchronizes paths across opened tabs.
  • Deleting workspace files automatically closes their corresponding editing tabs.
  • Renaming the root directory automatically synchronizes the managed Git repository path.

Git Integration

MarkTextPro incorporates Git as the core version control foundation for file workspaces. Work on Markdown files in the editing area, or switch to the Git area for commits, pulls, pushes, and history inspection.

flowchart LR
  Editor["Editor Area"] -- "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 Workspace to Current Repository or Subfolder"]
  Confirm -- "Confirm without Switching Workspace" --> GitOnly["Switch Git Repository Only"]
  Workspace --> Reload["Close Opened Files & Reload Workspace"]
  Editor -- "Rename Root Directory" --> Sync["Synchronize Managed Git Repository Path"]
  Sync --> Git

Interactions:

  • Select repositories in the Git area with confirmation prompts to prevent accidental clicks.
  • By default, checking "Switch Workspace" aligns the file workspace with the selected Git repository.
  • Unchecking allows switching the Git repository while keeping the current file workspace intact.
  • Set the current repository root or subfolder as the file workspace from the Git area.
  • If the workspace root is renamed, MarkTextPro automatically updates the Git repository path.

Security & Git Guidelines

  1. Strongly Recommend Private Repositories:
    • Workspaces typically contain code, documentation, server configurations, technical assets, and sensitive personal data. Strongly recommend setting remote Git repositories (GitHub, Gitee, GitLab) to Private to prevent accidental disclosure or search engine indexing.
  2. Never Expose KDBX Keystores to Public Repositories:
    • Although KDBX employs strong cryptographic standards protected by master passwords, never push .kdbx files to public repositories! Public exposure makes files vulnerable to offline dictionary and brute-force attacks. Add *.kdbx to .gitignore for public repositories.
  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

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

Download & Installation

platform

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

💡 Sibling Project: If you need structured local notes, personal knowledge bases, and document hierarchy management, visit MarkNotePro Baidu Netdisk Download or MarkNotePro Gitee Mirror (GitHub page: MarkNotePro Releases).

Package Formats:

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

Development

pnpm install
pnpm --filter marktextpro dev

Build desktop client:

pnpm --filter marktextpro build

License & Commercial Authorization

This project is licensed under the MarkTextPro 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 MarkTextPro (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

MarkTextPro 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).