做 Markdown 編輯器的人應(yīng)該都聽過 MarkText 這個名字。這是一款免費(fèi)開源的“所見即所得” Markdown 編輯器支持 Windows、macOS、Linux 三個平臺核心優(yōu)勢就四個字干凈、輕量。標(biāo)題里既然寫了 2026 最新我就順著這條線把 MarkText 下載、安裝、漢化的完整流程重新捋一遍盡量覆蓋版本選擇、不同系統(tǒng)的安裝姿勢、中文界面設(shè)置、配置優(yōu)化和常見坑基本能幫你做到“拿到安裝包十分鐘內(nèi)用起來”。這篇文章適合幾類人剛換電腦要重裝 MarkText 的老用戶第一次聽說這個編輯器想找個免費(fèi)替代方案的新手裝完后發(fā)現(xiàn)界面是英文不知道從哪里切中文的人以及被各類下載站廣告和捆綁軟件坑過想走一條穩(wěn)妥安裝路徑的人。我這些年給同事裝過、遠(yuǎn)程幫朋友處理過、也折騰過好幾臺不同系統(tǒng)的機(jī)器接下來寫的每一步基本都踩過真實(shí)的問題不是搬運(yùn)官方文檔的那種寫法。1. 先弄清楚 MarkText 的核心價值與適用人群1.1 它是“所見即所得”的 Markdown 編輯器MarkText 是一個基于 Electron 開發(fā)的開源項(xiàng)目最初在 GitHub 上發(fā)布設(shè)計(jì)目標(biāo)非常明確做一個像 Typora 一樣打開就能寫、寫完就能導(dǎo)出的 Markdown 工具。所謂“所見即所得”就是你在編輯器里直接寫# 標(biāo)題、**加粗**、- 列表這些語法時按下回車或切換段落它會實(shí)時渲染成最終的顯示效果不需要左邊源碼、右邊預(yù)覽這樣的雙欄布局。對只想專注寫作的人來說這個體驗(yàn)是決定性的。MarkText 支持 GFM 表格、任務(wù)列表、代碼高亮、LaTeX 數(shù)學(xué)公式、流程圖和序列圖還支持把圖片直接粘貼進(jìn)文檔。它不像 VS Code 那樣插件越裝越多、配置越調(diào)越復(fù)雜也不像某些在線筆記工具那樣強(qiáng)制綁定賬號和云端存儲。MarkText 打開就是一個本地文件夾你的所有文檔都以標(biāo)準(zhǔn).md文件保存完全可以配合 Git、網(wǎng)盤或者堅(jiān)果云做同步自由度很高。1.2 與 Typora、VS Code 的取舍在 Markdown 編輯器這個領(lǐng)域大家最常拿來和 MarkText 比較的就是 Typora 和 VS Code。三個工具定位其實(shí)不一樣我直接列個表對比維度MarkTextTyporaVS Code授權(quán)模式開源免費(fèi)商業(yè)付費(fèi)開源免費(fèi)編輯方式所見即所得所見即所得源碼編輯 預(yù)覽數(shù)學(xué)公式支持支持需插件導(dǎo)出PDF、HTMLPDF、HTML、Word 等插件擴(kuò)展插件生態(tài)幾乎沒有幾乎沒有非常豐富適合場景筆記、博客、日記筆記、學(xué)術(shù)寫作開發(fā)、協(xié)同、大型文檔這幾年的實(shí)際感受是如果你只想快速記錄和寫作不希望被功能淹沒MarkText 足夠好用如果你要多人協(xié)作、代碼塊執(zhí)行、Git 集成這類能力還是直接選 VS Code。Typora 目前是收費(fèi)軟件單論 Markdown 編輯體驗(yàn)和 MarkText 最接近但付費(fèi)墻天然勸退了很多用戶。MarkText 最大的價值就在這里它是一個免費(fèi)且開源的替代品本地優(yōu)先界面清爽不需要訂閱也沒有廣告。2. 下載前的關(guān)鍵準(zhǔn)備版本、渠道、文件校驗(yàn)2.1 別被“標(biāo)題黨”帶偏穩(wěn)定版本怎么選這里要先說一個很多人會疑惑的問題MarkText 最新版本是多少答案是 v0.17.1。這個版本發(fā)布于 2021 年左右之后項(xiàng)目進(jìn)入維護(hù)放緩的狀態(tài)但直到 2026 年的今天它依然是社區(qū)公認(rèn)的穩(wěn)定版本。網(wǎng)上有些下載站會寫“MarkText 2026 最新版”點(diǎn)進(jìn)去實(shí)際提供的還是 0.17.x 甚至更老的版本只是包裝了一個看起來很新的名字。選中版本時有個很實(shí)際的原則能裝 0.17.1 就不要裝 0.15 或更早的版本因?yàn)?0.16 到 0.17 之間修復(fù)了大量崩潰問題包括 Windows 快捷鍵異常、Linux 下渲染卡頓、部分文檔打開閃退等。如果你看到有人推薦某個“魔改版”或“增強(qiáng)版”也盡量別碰你并不能確定里面加了多少私貨。MarkText 的開源特性決定了你完全可以自己從源碼構(gòu)建但沒必要官方 Release 的預(yù)編譯包就是最穩(wěn)的選擇。2.2 官方發(fā)布渠道與安裝包命名規(guī)律下載 MarkText 最靠譜的地方是 GitHub 上 marktext/marktext 倉庫的 Release 頁面里面列出的文件命名有規(guī)律可循Windows 安裝版marktext-setup-x64.exeWindows MSI 版marktext-0.17.1-x64.msimacOS 鏡像MarkText-0.17.1-x64.dmgLinux Debian 包marktext_0.17.1_amd64.debLinux 免安裝MarkText-0.17.1-x64.AppImage如果你所在地區(qū)的網(wǎng)絡(luò)訪問 GitHub 體驗(yàn)一般也可以使用常見的開源軟件鏡像站或者讓朋友把安裝包轉(zhuǎn)存到網(wǎng)盤。這里有一個很關(guān)鍵的提醒從非官方渠道下載后不要急著雙擊安裝先確認(rèn)文件體積和官方 Release 頁面的標(biāo)注是否一致。很多下載站會把安裝包重新打包塞進(jìn)推廣軟件或捆綁安裝體積往往會多出幾十 MB仔細(xì)看一眼就能發(fā)現(xiàn)問題。2.3 下載后做一步校驗(yàn)杜絕夾帶風(fēng)險(xiǎn)文件校驗(yàn)聽起來很技術(shù)實(shí)際操作也就一分鐘。Windows 用戶在 PowerShell 里執(zhí)行Get-FileHash .\marktext-setup-x64.exe -Algorithm SHA256macOS 和 Linux 用戶在終端里執(zhí)行shasum -a 256 MarkText-0.17.1-x64.dmgsha256sum marktext_0.17.1_amd64.deb把終端輸出的那串哈希值和 Release 頁面列出的 SHA-256 值對比一致說明文件沒有被改動過。這個方法不只是用在 MarkText 上以后下載任何開源軟件都建議保留這個習(xí)慣。校驗(yàn)通過再進(jìn)入安裝環(huán)節(jié)心里會踏實(shí)很多。3. Windows/macOS/Linux 三平臺的完整安裝步驟3.1 Windowsexe 與 msi 兩種裝法Windows 下最常見的做法是雙擊marktext-setup-x64.exe進(jìn)入安裝向?qū)б宦?Next 就行。雖然安裝路徑可以自定義但我個人建議保持默認(rèn)位置尤其是不要放在含中文命名的目錄里。Electron 應(yīng)用一般來說也能運(yùn)行但以后排查問題的時候路徑里如果有中文或空格會增加很多不必要的麻煩。.msi安裝包主要用于企業(yè)批量部署場景。還有一種靜默安裝方式在命令行里執(zhí)行marktext-setup-x64.exe /S這條命令適合企業(yè)統(tǒng)一裝機(jī)或者遠(yuǎn)程協(xié)助時快速部署執(zhí)行后不會彈出圖形界面直接裝完。如果是個人使用雙擊圖形向?qū)Х炊庇^可以看清楚安裝到了哪里、有沒有勾選額外選項(xiàng)。裝完后桌面會出現(xiàn) MarkText 圖標(biāo)第一次啟動如果被 Windows Defender SmartScreen 攔截點(diǎn)擊“更多信息”再選擇“仍要運(yùn)行”即可。開源軟件沒有購買商業(yè)簽名證書這是正常現(xiàn)象。注意如果某些網(wǎng)站或安裝包提示你“必須關(guān)閉殺毒軟件才能安裝”基本可以判定安裝包有問題。正規(guī)開源軟件的安裝流程不要求你做這種高危操作。3.2 macOSdmg 安裝與隔離屬性macOS 用戶下載到的是MarkText-0.17.1-x64.dmg雙擊打開后把 MarkText.app 拖進(jìn) Applications 目錄就算完成安裝。第一次打開時系統(tǒng)很可能會彈出“無法打開因?yàn)?Apple 無法檢查其是否包含惡意軟件”的提示原因是軟件沒有經(jīng)過 App Store 公證。解決辦法很簡單在訪達(dá)里右鍵點(diǎn)擊 MarkText.app選擇“打開”系統(tǒng)會彈出二次確認(rèn)點(diǎn)擊確認(rèn)后就能正常使用了。如果提示變成了“應(yīng)用程序已損壞”或者右鍵“打開”也無反應(yīng)通常是因?yàn)?macOS 安全策略隔離了從網(wǎng)絡(luò)下載的應(yīng)用。打開終端執(zhí)行sudo xattr -cr /Applications/MarkText.app這條命令的作用是清除應(yīng)用上的隔離屬性告訴系統(tǒng)這個文件可以信任。執(zhí)行完再打開基本就沒有問題了。另外要說明一點(diǎn)0.17.1 官方包是 x64 架構(gòu)的在 Apple SiliconM1/M2/M3 等機(jī)器上會通過 Rosetta 2 轉(zhuǎn)譯運(yùn)行。首次啟動時系統(tǒng)會提示你安裝 Rosetta點(diǎn)擊同意即可。實(shí)際使用體驗(yàn)影響很小日常寫文檔、渲染公式、導(dǎo)出 PDF 都沒有明顯延遲。3.3 LinuxAppImage 和 deb 包Linux 用戶有兩種推薦安裝方式。如果你用的是 Debian/Ubuntu 系發(fā)行版可以下載.deb包然后用 dpkg 安裝sudo dpkg -i marktext_0.17.1_amd64.deb如果提示依賴缺失再執(zhí)行sudo apt --fix-broken install補(bǔ)一下就能裝完。另一條路是使用 AppImage 免安裝包先給文件加執(zhí)行權(quán)限再運(yùn)行cd ~/Downloads chmod x MarkText-0.17.1-x64.AppImage ./MarkText-0.17.1-x64.AppImageAppImage 的優(yōu)勢是免安裝、可攜帶適合臨時使用。但有一個很常見的坑系統(tǒng)缺少libfuse2時雙擊 AppImage 不會報(bào)錯只會在桌面毫無反應(yīng)。遇到這種情況在終端里運(yùn)行一下能看到錯誤輸出然后安裝依賴就能解決sudo apt install libfuse2Fedora、Arch 等發(fā)行版雖然不一定有官方打包的 rpm 或 pacman 包但直接運(yùn)行 AppImage 通常也能覆蓋大部分使用場景。4. 漢化與中文界面設(shè)置全流程4.1 首選方式在設(shè)置里切換簡體中文看到這里很多人可能會松一口氣MarkText 本身內(nèi)置了多語言支持簡體中文是官方提供的語言之一。也就是說絕大多數(shù)情況下“漢化”根本不用下載任何補(bǔ)丁只需要在設(shè)置里切換語言。啟動 MarkText 后按Ctrl,macOS 是Cmd,打開 Preferences左側(cè)選擇 General右側(cè)找到 Language 這個選項(xiàng)下拉列表里選擇 Chinese (Simplified)保存后軟件會提示重啟。完全退出再重新打開界面就會變成中文。這一步就是 90% 用戶需要的“漢化教程”。網(wǎng)上之所以流傳各種漢化包和補(bǔ)丁主要是因?yàn)楹芏嘤脩粲玫氖蔷G色免安裝版、老版本或者非官方重新打包的版本這些版本可能把語言文件刪掉了語言下拉列表里只有 English。這時候才需要下面講到的手動處理思路。4.2 手動漢化的通用做法如果你的版本確實(shí)沒有中文選項(xiàng)可以試試手動改配置。先把 MarkText 完全退出然后找到用戶配置目錄。Windows 下通常在C:\Users\你的用戶名\AppData\Roaming\marktextmacOS 下在~/Library/Application Support/marktextLinux 下在~/.config/marktext在這個目錄里找一個類似preferences.json或config.json的 JSON 文件用編輯器打開搜索language或locale字段把值改成zh-CN。如果沒有這個字段也可以手動加一行l(wèi)anguage: zh-CN保存后重新啟動。注意修改時一定要保持 JSON 格式正確逗號、花括號都不能少。如果這樣改完界面依舊沒有變化那基本可以判斷這個版本的語言資源文件本身不完整。你可以去 MarkText 項(xiàng)目源碼倉庫的 i18n 目錄根據(jù)版本不同也可能是 locale/lang 目錄找對應(yīng)的zh-CN語言文件復(fù)制到安裝目錄資源目錄下的對應(yīng)語言文件夾里再重啟一次。這個方法比改配置稍微麻煩一點(diǎn)但適合處理網(wǎng)上流傳的那些殘缺版。提示漢化后偶爾會出現(xiàn)菜單位置一半中文一半英文的情況多半是語言文件的部分條目還沒翻譯屬于正常現(xiàn)象不影響核心使用。4.3 漢化后讓中文顯示更舒服切到中文界面后再做一步優(yōu)化體驗(yàn)會好很多。MarkText 默認(rèn)的字體和內(nèi)邊距是按英文習(xí)慣設(shè)計(jì)的中文顯示出來后可能會顯得偏擠。可以在 Preference 里找到字體或主題相關(guān)設(shè)置把中文字體改成“微軟雅黑”“蘋方”或“思源黑體”編輯區(qū)字號調(diào)到 16px 以上行高 1.5 左右。尤其是長時間寫中文文章的人這幾步對眼睛非常友好。5. 裝好之后的關(guān)鍵配置與使用建議5.1 界面主題和排版調(diào)整MarkText 自帶多套界面主題包括淺色、深色以及一套類似 One Dark 的配色方案。我個人強(qiáng)烈建議把主題切換成深色寫文檔時注意力更容易集中在文字上。設(shè)置入口在 Preferences 里的 Theme 頁你還可以單獨(dú)調(diào)整代碼高亮主題、正文字體和行高。另外要注意一個細(xì)節(jié)MarkText 窗口頂部默認(rèn)不顯示傳統(tǒng)菜單欄而是把常用功能和設(shè)置藏在工具欄、右鍵菜單和快捷鍵里。很多新手裝完后找不到保存按鈕和導(dǎo)出按鈕其實(shí)保存用CtrlSmacOS 用CmdS就行導(dǎo)出在文件菜單或窗口右下角的導(dǎo)出入口里。這個設(shè)計(jì)剛上手時可能不太習(xí)慣但它換來的是非常干凈的編輯區(qū)域適合沉浸式寫作。5.2 圖片粘貼和導(dǎo)出功能MarkText 支持從剪貼板直接粘貼圖片粘貼時默認(rèn)會把圖片保存為一個本地文件再把相對路徑寫進(jìn)文檔。如果你有固定的圖片目錄需求可以在設(shè)置里指定一個全局圖片保存路徑這樣所有文檔的圖片都集中管理寫博客配圖時會非常方便。我自己的習(xí)慣是在文稿目錄下建一個assets文件夾所有圖片都存在這里導(dǎo)出或轉(zhuǎn)移到其他設(shè)備時路徑結(jié)構(gòu)很清晰。導(dǎo)出功能方面MarkText 支持導(dǎo)出為 PDF 和 HTML。PDF 導(dǎo)出遇到中文顯示為方塊的問題通常是系統(tǒng)缺少中文字體安裝“思源黑體”“Noto Sans CJK”或“文泉驛”這類字體就能解決。HTML 導(dǎo)出則會生成一個單文件頁面適合快速分享或作為臨時網(wǎng)頁打開。5.3 常用快捷鍵速查這里把最常用的快捷鍵整理成表方便大家復(fù)制到自己的筆記里功能Windows / LinuxmacOS加粗CtrlBCmdB斜體CtrlICmdI插入鏈接CtrlKCmdK插入代碼CtrlShiftCCmdShiftC保存CtrlSCmdS偏好設(shè)置Ctrl,Cmd,這些快捷鍵并不是 MarkText 獨(dú)有但很多人從 Windows 換到 Mac 后經(jīng)常按錯。我的建議是頭幾天先用默認(rèn)快捷鍵等形成肌肉記憶了再考慮自定義。設(shè)置里確實(shí)可以改快捷鍵但改完記得寫進(jìn)自己的筆記免得過兩周自己都忘了。6. 常見問題排查與避坑經(jīng)驗(yàn)6.1 雙擊打不開、閃退這是我在線下處理時遇到最多的一類問題。先做最簡單的排查安裝包是不是從官方渠道下載的殺毒軟件或系統(tǒng)安全中心有沒有攔截和隔離文件。如果確認(rèn)文件沒問題Windows 上打開就閃退多半和顯卡渲染有關(guān)。Electron 應(yīng)用在老舊或不兼容的顯卡驅(qū)動下運(yùn)行時GPU 加速崩潰是常見現(xiàn)象。可以給啟動命令臨時加上參數(shù)C:\Program Files\MarkText\MarkText.exe --disable-gpu如果加了參數(shù)能正常打開說明問題就出在 GPU 加速上。你也可以嘗試更極端的--no-sandbox參數(shù)但我要強(qiáng)調(diào)這會降低軟件的安全性只能用于定位問題不建議長期使用。macOS 上閃退還常見于配置文件損壞的場景?？梢园褈/Library/Application Support/marktext這個目錄暫時改個名字讓軟件重新生成配置。如果能正常啟動再把舊配置里的主題、語言等關(guān)鍵設(shè)置手動搬回來不要整個覆蓋回去因?yàn)閱栴}可能就出在某個老配置字段上。6.2 漢化之后界面沒有任何變化漢化不生效第一步不是重新找漢化包而是確認(rèn)有沒有真正“完整退出并重啟”。MarkText 在某些系統(tǒng)上關(guān)閉窗口只是隱藏到托盤進(jìn)程沒有退出。你在設(shè)置里切換語言后它提示重啟生效但你只是關(guān)掉了窗口又打開進(jìn)程其實(shí)還是同一個語言自然不會切換。Windows 上建議打開任務(wù)管理器確認(rèn) MarkText 相關(guān)進(jìn)程都結(jié)束了再重新啟動。第二步檢查配置文件是否真的寫入了zh-CN。如果配置也改了、進(jìn)程也重啟了但還是英文再考慮版本問題。網(wǎng)上那些所謂“漢化補(bǔ)丁”很多是針對 0.14 以下的版本制作的直接用在 0.17.1 上基本無效。還有一部分綠色版是從精簡過的安裝包里解包出來的語言文件本身就不全所以只能下回找完整版重新安裝。6.3 中文輸入法不跟手這個在 Linux 桌面上尤其明顯尤其是 Wayland 會話下Electron 舊版本和某些輸入法框架配合不穩(wěn)定表現(xiàn)為候選框不跟隨光標(biāo)、輸入中文時文字凝固在編輯器角落。嘗試方向有三個把桌面會話切回 X11 測試升級或更換系統(tǒng)輸入法引擎如果都不行換一個基于較新 Electron 的 Markdown 編輯器。Windows 上如果輸入法候選框不跟隨光標(biāo)一般是輸入法兼容模式的問題切換成兼容模式就好。這個問題雖然體驗(yàn)糟糕但原因清楚后處理路徑其實(shí)很明確。6.4 更多容易踩的細(xì)節(jié)再分享幾個印象很深的細(xì)節(jié)坑都是我實(shí)際遇到過或者幫別人處理過的。Linux 下用 AppImage 時系統(tǒng)沒有安裝 FUSE 依賴雙擊不會彈窗報(bào)錯只會在桌面一閃而過很容易被誤判為軟件本身壞了。遇到這種情況到終端里手動運(yùn)行一下看輸出中缺什么依賴再針對性安裝。不要把 MarkText 的配置目錄放到網(wǎng)盤實(shí)時同步文件夾里尤其是開著兩臺電腦同時使用的時候。配置文件被兩端同時寫入會互相鎖死輕則設(shè)置丟失嚴(yán)重時可能引發(fā)崩潰。我踩過這個坑后配置目錄只在手動備份時才拷貝。導(dǎo)出 PDF 時中文變成方塊原因不是 MarkText 的問題而是系統(tǒng)缺少中文字體導(dǎo)致的。安裝“Noto Sans CJK”“思源黑體”或“文泉驛微米黑”重新導(dǎo)出即可。Windows 上如果安裝了中文字庫但導(dǎo)出依舊異常大概率是 PDF 引擎的字體回退設(shè)置問題換個默認(rèn)字體就好。Windows 靜默安裝參數(shù)/S在部分安全軟件里會被誤報(bào)為“靜默執(zhí)行非法程序”。如果你打算在公司批量部署先在測試機(jī)上驗(yàn)證一遍以免被終端管理策略攔截。6.5 問題排查速查表現(xiàn)象可能原因處理辦法雙擊無反應(yīng)文件被安全中心攔截檢查安全中心的攔截記錄恢復(fù)文件打開后白屏或閃退GPU 渲染異常加--disable-gpu參數(shù)啟動漢化不生效沒有完全退出進(jìn)程結(jié)束后臺進(jìn)程再重啟或檢查配置文件Linux 雙擊 AppImage 無反應(yīng)缺少 libfuse2sudo apt install libfuse2后重試導(dǎo)出 PDF 中文是方塊系統(tǒng)中文字體缺失安裝 Noto Sans CJK 或思源黑體macOS 提示“已損壞”隔離屬性未清除執(zhí)行sudo xattr -cr后重新打開這張表是我實(shí)際排查問題時最常用的思考路徑覆蓋面不一定全但絕對都是高頻現(xiàn)象。如果你遇到的報(bào)錯不在這張表里建議在終端或命令提示符里直接運(yùn)行安裝目錄下的可執(zhí)行文件看日志輸出的具體錯誤信息往往比到處搜索問題描述更快。7. 最后分享一點(diǎn)個人經(jīng)驗(yàn)7.1 對“停更”項(xiàng)目的心態(tài)調(diào)整如果你因?yàn)?MarkText 更新不多而猶豫要不要用我的建議是換個角度看待它:它是一個已經(jīng)打磨完成、功能穩(wěn)定的工具而不是一個需要不停追新的在線服務(wù)。它的定位很明確本地寫作、標(biāo)準(zhǔn) Markdown、把導(dǎo)出和渲染做好。這類軟件對“最新版本”的依賴沒有那么強(qiáng)即使項(xiàng)目真的完全停止更新你手里的版本也依然能用很多年。就像一臺老式機(jī)械鍵盤沒有新功能但打字手感就是舒服。7.2 裝新機(jī)器前記得備份配置目錄最后再分享一個我堅(jiān)持了多年的小習(xí)慣每次重裝系統(tǒng)或換電腦之前把 MarkText 的配置目錄整個備份一遍。這個目錄通常很小從幾百 KB 到幾 MB但里面存著主題、快捷鍵、語言、圖片路徑等所有自定義設(shè)置。新機(jī)器裝好最新版后直接把備份目錄放回去軟件馬上恢復(fù)到熟悉的配置不需要重新調(diào)一遍。如果你之前在用 0.16 或更早的版本升級 0.17.1 之前也要先備份萬一新版不習(xí)慣回退舊版時所有配置還在。希望這份 MarkText 下載、安裝和漢化的全流程記錄能幫你少走點(diǎn)彎路。工具終究是服務(wù)于寫作的配置穩(wěn)定之后剩下的就是把時間花在真正想寫的內(nèi)容上。