MarkText 跨平台 Markdown 编辑器完全指南:从安装、WYSIWYG 写作到源码构建(基于官方日文文档与仓库源码)

发布时间:2026/9/18 8:01:28

MarkText 跨平台 Markdown 编辑器完全指南:从安装、WYSIWYG 写作到源码构建(基于官方日文文档与仓库源码) 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),仅供参考
延伸阅读

更多相关文章

2026/9/18 8:01:28

9款高效AI工具推荐:学生与职场新人必备

1. 项目概述作为一名在AI工具应用领域深耕多年的实践者,我经常收到专科院校学生和职场新人的咨询:面对市面上五花八门的AI工具,如何选择真正适合自己的?哪些工具能切实提升学习效率而不是制造更多麻烦?今天我就结合自己…

2026/9/18 7:56:28

像蜂鸟一样轻快:Colibri轻量级CMS部署与扩展实践

第一次看到“Colibri”这个名字,我脑子里蹦出来的是那种能在半空悬停的蜂鸟。后来翻完项目说明才发现,这个开源项目取名是真没偷懒——它想做的就是一个像蜂鸟一样轻巧、灵活、反应快的内容管理系统。跟那些动辄几百兆、后台配置项密密麻麻的“重型CMS”…

2026/9/18 9:56:42

OpenResearch接入Overleaf全解:浏览器Cookie导入与实时同步

OpenResearch接入Overleaf全解:浏览器Cookie导入与实时同步 【免费下载链接】OpenResearch Turn your coding agents into research agents 项目地址: https://gitcode.com/GitHub_Trending/op/OpenResearch OpenResearch 把编码 Agent 变成研究 Agent&#…

2026/9/18 9:56:42

USP <1058>分析仪器确认中英文对照与四Q模型实操指南

简介:这份依据美国药典第1058章通则整理的分析仪器确认中英文对照电子文档,主要面向制药企业质量管理、实验室分析人员及仪器确认工程师,帮助厘清仪器确认与验证、系统适用性之间的差异,解决实际工作中对确认流程理解不清的问题。…

2026/9/18 9:56:42

CANN opbase DFX_IN 宏详解:L2 一阶段接口入参封装与 DFX 插桩机制

CANN opbase DFX_IN 宏详解:L2 一阶段接口入参封装与 DFX 插桩机制 【免费下载链接】opbase 本项目是CANN算子库的基础框架库,为算子提供公共依赖文件和基础调度能力。 项目地址: https://gitcode.com/cann/opbase DFX_IN 是 CANN opbase 算子开发…

2026/9/18 9:56:42

Agent-Reach:智能体触达层与工具调用、幂等、审计实践

去年我帮一个内部团队做智能体落地,模型换了三代,demo 每次都惊艳,但真正推上线卡了整整两个月。卡点不在模型,而在"最后一公里":工具调不动、消息发不出去、外部系统回调不进来、出了事查不到是谁干的。后来…

2026/9/18 9:51:42

YOLOv8到YOLO26:五代目标检测模型对比与迁移选型指南

说实话,这两年我是被身边人反复问同一个问题问怕了:“你说我要不要把手里的训练代码换成新版?”YOLO系列的版本迭代速度快到让人麻木,从v8到v10再到v11、v12,几乎每半年就出一个新版本,现在又冒出来一个YOL…

2026/9/16 12:52:37

拯救者Y7000黑屏故障排查与维修实战指南

1. 项目概述:一台黑屏的拯救者Y7000,到底卡在哪一步? 联想拯救者Y7000系列笔记本,从2018年第一代搭载i5-8300H开始,到后来的i7-9750H、i7-10750H、i5-11400H,再到2023年款的R7-7840HS,它始终是学…

2026/9/18 0:01:09

Google Colab 实战:运行模型、数据加载与报错排查

1. 为什么我劝你先搞懂 Colab 的运行模型1.1 Colab 到底是什么,跟本地跑代码差在哪Google Colab 简单说就是一台跑在浏览器里的 Linux 虚拟机,你打开一个 Notebook,背后就连上了一台带 GPU 的远程机器。你在单元格里敲的每一行 Python&#x…

2026/9/18 0:01:09

C语言数据类型与表达式详解

1. C语言数据与数据类型概述在C语言编程中,数据是程序处理的核心对象。理解数据的分类和特性是掌握C语言的基础。C语言中的数据主要分为四大类:常量、变量、表达式和函数。这些数据类型构成了C语言程序的基本元素,每种类型都有其独特的特性和…

2026/9/18 0:01:09

SQL时间字段指定时间段查询:区间语义、索引与时区避坑

上周排查一个线上问题&#xff0c;用户反馈"昨天的订单一条都没查到"&#xff0c;但数据库里明明躺着两千多条。最后定位下来&#xff0c;不是数据丢了&#xff0c;也不是接口挂了&#xff0c;而是那个查询条件把时间段写成了> 2024-05-20 00:00:00 AND < 2024…

2026/9/16 22:55:57

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行&#xff0c;Type-C接口算是典型的“看着简单&#xff0c;做起来全坑”的东西。光引脚就24个&#xff0c;高低速信号、电源、控制线全部塞在一个小小的连接器里&#xff0c;如果PCB布局不做规划&#xff0c;打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/16 22:56:09

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/16 22:56:16

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
咨询二维码