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