[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83245":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":13,"stars7d":15,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":16,"compositeScore":17,"rankGlobal":9,"rankLanguage":9,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":9,"pushedAt":9,"updatedAt":23,"readmeContent":24,"aiSummary":9,"trendingCount":14,"starSnapshotCount":14,"syncStatus":25,"lastSyncTime":26,"discoverSource":27},83245,"bookMDViewer","craig7351\u002FbookMDViewer","craig7351","opensource md viewer",null,"TypeScript",93,13,1,0,19,5,3.44,"MIT License",false,"main",true,[],"2026-06-12 02:04:32","# Markdown Viewer\n\n**繁體中文** | [English](README.en.md)\n\n一款**輕量、完全本機**的 Markdown 檢視器與編輯器,支援 Windows、macOS 與 Linux。\n以 **Tauri v2** 打造,使用作業系統內建的 WebView(Windows 用 WebView2、macOS 用\nWKWebView、Linux 用 WebKitGTK),而非內嵌整個 Chromium —— 因此 Windows 執行檔僅\n**約 4 MB**,閒置記憶體約 **30–60 MB**。\n\n雙擊任何 `.md` 檔即可瞬間開啟、漂亮渲染 —— 內建可導覽的章節大綱、程式碼語法高亮、\nMermaid 圖表、可即時預覽的編輯器,以及一鍵匯出成自包含的 HTML 檔。沒有安裝包肥大、\n沒有雲端、沒有遙測,全部離線運作。\n\n## 螢幕截圖\n\n### 閱讀模式 —— 大綱 + 渲染後的 Markdown\n\n左側的**章節大綱(TOC)**會依文件標題自動產生;點任一項即可跳轉,並會高亮你目前\n正在閱讀的章節。\n\n![閱讀模式與大綱側欄](docs\u002Fscreenshots\u002Fviewer.png)\n\n### 編輯模式 —— 即時編輯與預覽\n\n按 **Edit**(或 `Ctrl+E`)開啟分割編輯器。預覽會隨輸入即時更新,左右兩欄**同步捲動**,\n按 `Ctrl+S` 即可存回磁碟。\n\n![編輯模式與即時預覽](docs\u002Fscreenshots\u002Feditor.png)\n\n## 功能特色\n\n- **GFM 渲染** —— 表格、任務清單、刪除線(`markdown-it`)\n- **程式碼語法高亮**(`highlight.js`)\n- **Mermaid 圖表** —— 延遲載入,只有文件實際含有 ` ```mermaid ` 區塊時才載入,\n  純文字文件完全不需付出這份成本\n- **大綱 \u002F TOC 側欄** —— 依標題自動建立、捲動時高亮目前章節、可用 `Ctrl+\\` 收合\n- **即時編輯與預覽** —— 分割編輯器、左右同步捲動(`Ctrl+E`)、`Ctrl+S` 存檔,\n  關閉時若有未存檔變更會跳出確認\n- **匯出 HTML** —— 在原檔旁產生單一自包含的 `.html`,內含大綱側欄、語法高亮的\n  程式碼,以及內嵌的 Mermaid SVG 圖\n- **即時重載** —— 監看開啟中的檔案,存檔後自動重新渲染\n- **檔案關聯** —— 雙擊任何 `.md` \u002F `.markdown` 檔即可開啟\n- **拖放** —— 把 Markdown 檔拖進視窗即可開啟\n- **文件內搜尋**(`Ctrl+F`)、**開啟檔案對話框**(`Ctrl+O`)與**最近開啟清單**\n- **YAML front matter** —— 開頭的 `---...---` 會渲染成漂亮的 metadata 卡片(標題、description、日期、標籤、Draft 徽章),而非亂掉的分隔線\n- **本機相對路徑圖片** —— 文件中 `![](images\u002Fx.png)` 會正確顯示\n- **安全** —— 渲染後的 HTML 會經過 DOMPurify 清理並套用嚴格 CSP,打開不信任的文件也不會執行惡意腳本\n- 深色 \u002F 淺色主題跟隨系統設定\n- 外部連結以你的預設瀏覽器開啟\n\n## 下載\n\n到 [**Releases**](https:\u002F\u002Fgithub.com\u002Fcraig7351\u002FbookMDViewer\u002Freleases\u002Flatest) 頁面取得最新版本:\n\n| 平台 | 檔案 |\n| --- | --- |\n| Windows(免安裝可攜版) | `Markdown.Viewer_*_x64_portable.exe` |\n| Windows(安裝版) | `Markdown.Viewer_*_x64-setup.exe` 或 `*_x64_en-US.msi` |\n| macOS(Apple Silicon \u002F Intel) | `*_aarch64.dmg` \u002F `*_x64.dmg` |\n| Linux | `*_amd64.AppImage`、`*_amd64.deb`、`*.x86_64.rpm` |\n\n> 安裝版會註冊 `.md` 檔案關聯(雙擊即可開啟);可攜版免安裝即可執行,但不會更改\n> 檔案關聯。所有版本都需要系統內建的 WebView(Windows 11 已預載 WebView2)。\n\n### macOS 首次開啟(重要)\n\n目前 macOS 版尚未經過 Apple 公證(notarization),加上近期 macOS 的安全限制越來越嚴格,\n第一次開啟時可能會被系統攔下(出現「無法打開,因為無法驗證開發者」之類的訊息)。\n請任選一種方式解除:\n\n- **右鍵開啟**(Ventura 以前):在 `Markdown Viewer.app` 上按右鍵 →「開啟」→ 再按一次「開啟」。\n- **系統設定**(Sonoma \u002F Sequoia):先雙擊一次被擋下後,到 **系統設定 → 隱私權與安全性**,\n  找到被阻擋的提示,按 **「仍要打開 \u002F Open Anyway」**。\n- **或用終端機執行一次**(清除隔離屬性):\n\n  ```bash\n  xattr -cr \"\u002FApplications\u002FMarkdown Viewer.app\"\n  ```\n\n之後就能正常開啟,不需要每次都做。\n\n### Linux 疑難排解\n\n若遇到白畫面、或 `libGLESv2.so.2: undefined symbol`(常見於不同 GPU\u002F驅動\u002F虛擬機環境),\nApp 已預設停用 WebKitGTK 的 DMABUF 渲染來繞過。若仍有問題,可在啟動前再加一個環境變數:\n\n```bash\nWEBKIT_DISABLE_COMPOSITING_MODE=1 .\u002FMarkdown.Viewer_*_amd64.AppImage\n```\n\n(也可反過來用 `WEBKIT_DISABLE_DMABUF_RENDERER=0` 還原預設行為。)\n\n## 鍵盤快捷鍵\n\n| 快捷鍵 | 動作 |\n| --- | --- |\n| `Ctrl+O` | 開啟檔案 |\n| `Ctrl+F` | 文件內搜尋 |\n| `Ctrl+E` | 切換編輯 \u002F 預覽 |\n| `Ctrl+S` | 存檔 |\n| `Ctrl+\\` | 切換大綱側欄 |\n| `Ctrl++` \u002F `Ctrl+-` | 字型放大 \u002F 縮小(也可用右上角 `A+` \u002F `A−` 按鈕) |\n\n## 啟動參數\n\n```bash\nmd-viewer.exe file.md            # 開啟並渲染\nmd-viewer.exe file.md --edit     # 直接進入編輯模式\nmd-viewer.exe file.md --zoom=1.5 # 整體 UI 放大(高 DPI \u002F 無障礙)\n```\n\n## 開發\n\n```bash\nnpm install\nnpm run tauri dev\n```\n\n## 在本機建置執行檔\n\n```bash\nnpm run tauri build\n```\n\n產出(Windows):`src-tauri\u002Ftarget\u002Frelease\u002Fmd-viewer.exe`,以及位於\n`src-tauri\u002Ftarget\u002Frelease\u002Fbundle\u002F` 的 NSIS \u002F MSI 安裝檔。\n\n## 跨平台發佈\n\n推送版本 tag,GitHub Actions 會建置 Windows \u002F macOS(Intel + Apple Silicon)\u002F\nLinux 安裝檔 —— 外加一個 Windows 可攜版 exe —— 並發佈到 release:\n\n```bash\ngit tag v1.0.0\ngit push origin v1.0.0\n```\n\n詳見 [.github\u002Fworkflows\u002Frelease.yml](.github\u002Fworkflows\u002Frelease.yml)。\n",2,"2026-06-11 04:10:31","CREATED_QUERY"]