MDViewer

快速上手

2026-07-27 921 字 約 2 分鐘

三種開啟本機 Markdown 的方式、介面配置說明，以及支援的檔案類型。

入門

MDViewer 在兩個地方算繪 Markdown：瀏覽器端閱讀器（直接開啟你電腦裡的檔案）與這份使用文件。兩者共用同一套算繪引擎與主題，所以這裡看到的效果，就是你自己檔案的效果。

開啟本機檔案

回到閱讀器首頁 ，用下面任一種方式：

方式 操作 適用情境
開啟資料夾 點「開啟資料夾」按鈕，或按 O 閱讀整個文件庫，可跨檔案搜尋與跳轉
開啟單一檔案 點「開啟單一檔案」，或按 Shift+O 只想看一篇
拖放 把資料夾或 .md 檔案拖到頁面任意位置 最快

說明

檔案不會上傳到任何伺服器。整個讀取與算繪過程都在瀏覽器內完成，關閉分頁即釋放。

瀏覽器相容性

開啟資料夾依賴 File System Access API ：

  • Chrome / Edge / Opera 86+：完整支援，包含記住上次開啟的資料夾
  • Safari / Firefox：自動退回到 <input webkitdirectory> 與拖放，仍可正常閱讀，但無法記住上次的目錄（每次都要重新選擇）

工作階段復原

用支援的瀏覽器開啟資料夾後，目錄控制代碼會存進 IndexedDB。下次造訪時：

  • 若權限仍然有效，會自動回到上次閱讀的檔案與捲動位置
  • 若權限過期，右下角會出現「繼續閱讀」提示，點一下重新授權即可

首頁的「最近開啟」清單保留最近 8 個工作區。

介面配置

  • 左側檔案樹：依目錄層級展開，頂端輸入框可依檔名篩選，B 收合
  • 中間內文：寬度、字級、行距、字型都能在設定裡調整，, 開啟設定
  • 右側大綱：從二級到四級標題自動產生，捲動時標示目前章節，T 收合

支援的檔案類型

閱讀器掃描目錄時會收錄：

  • 文件：.md .markdown .mdown .mkd .mdx .txt
  • 圖片：.png .jpg .gif .svg .webp .avif .bmp .ico（供 Markdown 中的相對路徑引用）

會自動略過 .git、node_modules、dist、build、.obsidian 等目錄，以及所有以 . 開頭的隱藏檔案。單次最多掃描 6000 個檔案、12 層深度。

相對路徑解析

文件裡這樣寫的圖片和連結都能正常運作：

1
2
3
4
5

![架構圖](./images/arch.png)
![上層目錄的圖](../assets/logo.svg)

[跳到另一篇](./advanced/config.md)
[目錄索引](../guide/)

圖片會從工作區裡找到對應檔案並產生本機 Blob URL；.md 連結會直接在閱讀器內跳轉，不重新整理頁面。找不到的目標會標紅並給出提示。

下一步