MarkText 跨平台 Markdown 编辑器完全指南从安装、WYSIWYG 写作到源码构建基于官方日文文档与仓库源码【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktextMarkText 是一款面向 Linux、macOS、Windows 的开源 Markdown 编辑器以速度与易用性为核心提供所见即所得WYSIWYG的实时预览与干净专注的写作界面。本文以仓库中的日文官方文档 docs/i18n/README-jp.md 为主体骨架结合仓库内安装、主题、构建等真实文档与源码完整讲解其功能特性、三平台安装方式、包管理器使用、常见问题排查以及从源码自行构建的开发流程读完即可独立完成 MarkText 的安装、配置与二次开发环境搭建。MarkText 是什么面向写作场景的次世代 Markdown 编辑器根据 docs/i18n/README-jp.md 的介绍MarkText 被定位为次世代Next generation的 Markdown 编辑器主打速度speed与易用性usability是一个简单、优雅的开源 Markdown 编辑器官方支持Linux、macOS、Windows三大桌面平台。从仓库结构看MarkText 是一个 pnpm monorepo 工程根目录 package.json 声明packageManager: pnpm10.33.4核心包含三个工作区包packages/desktop基于 Electron Vue 3 的桌面应用外壳主进程、预加载脚本、渲染进程packages/muyamuyajs/core使用 TypeScript 重写的编辑器内核Markdown 解析、块结构、WYSIWYG 渲染基于ot-json1 ot-text-unicode snabbdom marked构建packages/muyajs旧版 JS 编辑器引擎marktext/muyajs正被新内核逐步替代。编辑器引擎与桌面壳分离的架构详见 CLAUDE.md 的目录结构说明意味着 MarkText 的 Markdown 解析与渲染能力是独立、可测试的这也是它能同时保证解析规范性与渲染性能的底层原因。核心功能一览从 Markdown 规范到写作体验日文文档 docs/i18n/README-jp.md 明确列出了 MarkText 的核心功能本文逐条展开并补充仓库内的实现佐证1. 实时预览WYSIWYG与专注写作体验MarkText 提供实时预览What You See Is What You Get能力配合简洁干净的界面让写作者专注于内容本身。编辑器内所见即所得的效果由渲染进程中的编辑器内核负责渲染进程代码位于 packages/desktop/src/renderer/src其编辑器引擎消费muyajs/core见 packages/desktop/package.json 中的依赖声明muyajs/core: workspace:*。2. Markdown 规范支持完整支持CommonMark Spec与GitHub Flavored MarkdownGFMSpec部分支持 Pandoc Markdown语法仓库中 packages/muya/test/spec 下的commonmark.spec.ts、gfm.spec.ts、roundTrip.spec.ts即为对应规范的一致性测试conformance tests验证解析器对规范语法的符合度。3. Markdown 扩展数学公式KaTeX依赖katex见 packages/desktop/package.json支持行内与块级数学公式渲染Front MatterYAML 前置元数据Emoji 表情此外还支持Mermaid 图表、PlantUML、flowchart.js、Vega-Lite等图表扩展依赖列表中可见mermaid、flowchart.js、vega-embed等CLAUDE.md 的项目概述也确认了这一点。4. 写作效率快捷键支持段落级别与行内样式inline style的快捷键例如标题切换、加粗、斜体、引用、列表等提高写作效率。快捷键与命令绑定实现在 packages/desktop/src/main/keyboard 与 packages/desktop/src/common/keybinding并针对 macOS / Linux / Windows 分别提供键位配置。5. 导出能力可导出HTML与PDF文件。导出实现在主进程的文件系统模块中仓库测试 packages/desktop/test/unit/specs/exportHtml.spec.ts 与pdf.spec.ts等单元测试覆盖了导出逻辑。6. 主题系统内置多种主题文档特别提到Cadmium Light、Material Dark等。根据 packages/website/content/docs/end-user/THEMES.mdMarkText 内置33 个主题分为 Light浅色与 Dark深色两大类浅色主题包括 Ayu Light、Cadmium Light默认、Catppuccin Latte、Solarized Light 等深色主题包括 Cadmium Dark、Material Dark、One Dark、Dracula、Nord、Tokyo Night、Rosé Pine 等。主题可通过菜单 → Theme、偏好设置 → Theme 标签页切换也可以启用Follow System Theme跟随系统亮暗模式自动切换。主题的 label↔id 映射定义在 packages/desktop/src/main/menu/templates/theme.ts。7. 多种编辑模式支持源代码模式Source Code mode、打字机模式Typewriter mode与专注模式Focus mode源代码模式使用 CodeMirror 5 提供纯 Markdown 源码编辑依赖见 packages/desktop/package.json 中的codemirror打字机模式与专注模式则服务于沉浸式写作。8. 剪贴板直接粘贴图片支持从系统剪贴板直接粘贴图片到文档粘贴后会自动写入图片文件并插入引用相关测试见 packages/desktop/test/unit/specs/upload-image.spec.ts 与 muya 侧的pasteImage实现packages/muya/src/clipboard/pasteImage.ts。下载与安装三大平台与包管理器全解MarkText 随每个 release 发布预编译二进制文件支持平台覆盖Linux x64、macOS x64/arm64、Windows x64/arm64。以下安装说明综合 docs/i18n/README-jp.md 与仓库内更详细的 packages/website/content/docs/end-user/INSTALLATION.md。macOS 安装方式一从 release 页面下载最新的marktext-mac-(arm64|x64)-版本.dmg。注意官方不发布 Universal 通用构建请按芯片架构选择arm64Apple Silicon M 系列或x64Intel对应的安装包。安装后如遇 Gatekeeper 提示可右键应用选择打开以接受一次当前构建未做 notarization 公证。方式二使用 Homebrew Cask 安装需先安装 Homebrewbrew install --cask mark-textWindows 安装下载并运行安装向导marktext-setup-版本.exe可在用户级per-user与系统级machine wide两种安装方式中选择也支持便携版 zip解压即用数据可跟随应用存放详见 packages/website/content/docs/end-user/PORTABLE.md。安装完成后 MarkText 会自动注册为.md、.markdown、.mmd、.mdown、.mdtxt、.mdtext文件的默认打开程序。除安装向导外还可以使用包管理器需预先安装对应工具# Chocolatey choco install marktext # Windows Package Manager (Winget) winget install marktextLinux 安装Linux 是 MarkText 发布格式最丰富的平台共提供五种格式完整步骤见 packages/website/content/docs/end-user/LINUX.md格式适用场景marktext-linux-版本.AppImage推荐。无需 rootchmod x后直接运行兼容大多数发行版marktext-linux-版本.debDebian / Ubuntu / Linux Mint / Pop!_OS 等sudo apt install ./marktext-linux-版本.debmarktext-linux-版本.rpmFedora / RHEL / openSUSE 等sudo rpm -i marktext-linux-版本.rpmmarktext-linux-版本.snap支持 snap 的发行版sudo snap install marktext-linux-版本.snap --dangerous --classicmarktext-linux-版本.tar.gz便携 tar 包解压后运行其中的marktext可执行文件AppImage 使用要点packages/website/content/docs/end-user/LINUX.md# 1. 赋予可执行权限并运行 chmod x marktext-版本-x86_64.AppImage ./marktext-版本-x86_64.AppImage # 2. 集成到桌面环境可选创建 desktop entry 或使用 AppImageLauncher # 手动创建 desktop entry curl -L https://raw.githubusercontent.com/marktext/marktext/develop/resources/linux/marktext.desktop -o $HOME/.local/share/applications/marktext.desktop # 编辑该文件中的 Exec 为真实命令后 update-desktop-database $HOME/.local/share/applications/ # 3. 卸载删除 AppImage 文件、desktop 文件以及用户配置目录 ~/.config/marktextArch Linux 用户可通过 AUR 安装marktext-binyay -S marktext-bin该包会自动处理glibc、gtk3、nss、alsa-lib、libxss、cups、libxkbcommon、libxkbfile、mesa、hicolor-icon-theme等依赖。注意 AUR 包并非本仓库维护者维护版本可能滞后安装前建议核对 PKGBUILD 中的版本号。校验下载与更新、卸载校验每个 release 附带latest-平台.yml文件包含 SHA-512 哈希可用shasum -a 512 marktext-linux-版本.AppImage对比校验见 INSTALLATION.md。更新MarkText 启动时会检查更新可在偏好设置 → General → Updates关闭发现新版本后在后台下载、下次重启时安装便携版 zip 与 AppImage 不参与自动更新需要手动重新下载最新构件详见 INSTALLATION.md。卸载Windows 通过设置 → 应用或运行自带的Uninstall MarkText.exemacOS 直接删除 MarkText.app可同时清理~/Library/Application Support/marktextLinux 下.deb用sudo apt remove marktext、.rpm用sudo rpm -e marktext、snap 用sudo snap remove marktext、AppImage/tar.gz 直接删除文件即可。如需彻底清除用户数据删除对应的应用数据目录即可。命令行选项MarkText 还提供命令行接口详见 packages/website/content/docs/end-user/CLI.mdUsage: marktext [commands] [path ...] --debug 启用调试模式 --safe 禁用插件与其他用户配置 -n, --new-window 在第二实例时打开新窗口 --user-data-dir 修改用户数据目录 --disable-gpu 禁用 GPU 硬件加速 --disable-spellcheck 本次会话禁用拼写检查 -v, --verbose 输出详细日志 --version 打印版本信息 -h, --help 打印帮助信息在 macOS 上可创建便捷别名alias marktext/Applications/Mark\ Text.app/Contents/MacOS/Mark\ Text。从源码构建与开发模式如果希望自行构建 MarkText例如跟踪 develop 分支、为官方未发布的架构构建或参与开发请参考 packages/website/content/docs/dev/BUILD.md。要点如下环境前置条件Node.js20.19.0pnpm10根 package.json 声明enginesPython3.12供 node-gyp 编译原生模块C 编译器与开发工具构建在 Linux、macOS、Windows 上均受支持。Linux 额外依赖Debian 系sudo apt-get install libx11-dev libxkbfile-dev libsecret-1-dev libfontconfig-dev rpmRed Hat 系对应dnf install libX11-devel libxkbfile-devel libsecret-devel fontconfig-devel。构建步骤git clone https://github.com/marktext/marktext.git cd marktext pnpm install # 自动执行 postinstall 脚本打补丁、下载 Electron、重建原生模块、压缩 locale pnpm run build # 构建当前平台的二进制与安装包产物位于仓库根目录dist/文件夹electron-builder 输出中间产物在packages/desktop/out/。BUILD.md 还提供基于容器podman/docker的构建方式可在干净的 Debian bookworm 环境中一键完成依赖安装与构建。常用开发脚本BUILD.md 的脚本表脚本说明pnpm run build构建当前平台的二进制与安装包pnpm run dev以开发模式构建并运行 MarkText源码改动自动热重载渲染进程主进程改动需重启pnpm run lintESLint 代码风格检查pnpm run test运行单元测试Vitest开发模式中可用CtrlR手动重载渲染进程以提升开发效率详见 BUILD.md 的 TIP。平台专属构建命令包括pnpm run build:winNSIS 安装器 zip、pnpm run build:macDMG zipx64/arm64、pnpm run build:linuxAppImage、snap、deb、rpm、tar.gz这些命令在打包前会自动执行minify-locales与electron-rebuild。参与贡献从 Issue 到 Pull RequestMarkText 仍处于活跃开发中当前仓库版本为0.20.0-dev。如果你想参与提 Issue 时请使用默认的 issue 模板关于使用或功能问题均可直接创建 issue提交 Pull Request 前务必阅读贡献指南详见 packages/website/content/docs/dev/README.md 对应文档以及仓库内贡献规范PR 请提交到develop分支并在描述中关联相关 issue想了解项目规划可参考项目路线图roadmap与开放的 issue 列表深度开发者可进一步阅读 packages/website/content/docs/dev/ARCHITECTURE.md进程与模块分层、packages/website/content/docs/dev/IPC.mdmt::前缀 IPC 通道约定与 packages/website/content/docs/dev/DEBUGGING.md主进程/渲染进程调试等开发文档版本更新内容可查阅 packages/website/content/docs/CHANGELOG.md。许可证MarkText 以MIT License开源发布见根目录 LICENSE允许自由使用、修改与再分发。综上MarkText 通过 WYSIWYG 实时预览、CommonMark/GFM/Pandoc 语法支持、KaTeX 数学公式与图表扩展、丰富的主题与编辑模式为 Markdown 写作提供了完整的桌面体验同时凭借三平台二进制、主流包管理器Homebrew、Chocolatey、Winget、AUR支持以及清晰的可复现构建流程无论是普通写作者还是希望深入源码的开发者都能快速上手。本文所有安装命令与构建步骤均以当前仓库中的官方文档为准实际使用中请以对应平台的 release 页面与 packages/website/content/docs 下的用户/开发者文档为最新依据。【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktext创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考