從滿是符號的原始內容,到可以直接閱讀的文件
MD 檔案是使用 Markdown 語法編寫的純文字。一般文字編輯器會顯示標題符號、星號和連結語法,檢視器則把這些結構呈現成可閱讀的文件。你可以開啟本機檔案,也可以貼上 README 或筆記的原始內容。
這裡優先呈現閱讀結果。先用目錄或搜尋找到需要的段落,再調整閱讀寬度和字型;若要修改,點選「在編輯器中繼續」,即可在目前瀏覽器中開啟原始內容。
圍繞閱讀安排的檢視功能
先開啟檔案,再開始閱讀
支援 .md、.markdown 和 .txt 檔案,也可以拖入檔案。沒有檔案時,展開「貼上 Markdown」即可輸入原始內容。
定位章節和文字
目錄根據真實標題產生,重複標題有各自的連結。搜尋按原樣匹配文字,可前後跳轉;公式和圖表圖形不納入文字搜尋。
適合長文的閱讀設定
選擇字型、字級、行距、文件寬度,以及紙白、暖米色或深色底色。全螢幕閱讀讓正文佔據主要空間,按 Escape 可以退出。
保留原始內容或閱讀副本
下載 MD 保留可編輯的原始內容,下載 HTML 儲存閱讀副本。HTML 可包含目錄,搜尋醒目提示不會進入儲存的文件。
用這些文件檢查閱讀效果
閱讀一份專案 README
用短文件檢查目錄、清單和連結。
# 專案 README ## 安裝 執行 `npm install`。 ## 使用條件 - 現代瀏覽器 - 本機 Markdown 檔案 ## 說明 參考 [CommonMark 指南](https://commonmark.org/help/)。
- 使用目錄進入「使用條件」。
- 搜尋「瀏覽器」並跳轉到對應文字。
同名章節也能分別定位
相同的標題名稱不會指向同一個位置。
# 文件評審 ## 備註 第一位評審者的意見。 ## 備註 第二位評審者的意見。 ```text ## 程式碼裡的這一行不是標題 ```
- 兩個「備註」目錄項分別定位到各自章節。
- 程式碼區塊裡的標題語法不出現在目錄中。
開啟、定位,再保留一份副本
開啟檔案或貼上原始內容
選擇 MD 檔案、拖入檔案,或展開貼上區域。也可以先載入範例,檢查標題、程式碼與圖表的閱讀效果。
閱讀並定位內容
使用目錄進入章節,或搜尋一句話。外部圖片預設關閉,開啟後會向圖片所屬站點發起請求。
儲存或繼續編輯
下載 MD 保留原始內容,下載 HTML 留下閱讀副本。「在編輯器中繼續」僅在目前瀏覽器傳遞文字,不會產生公開分享地址。
分享前,檢查這幾項
| 內容 | 建議操作 | 可以期待的結果 |
|---|---|---|
| 圖片 | 先檢查圖片路徑,再決定是否載入外部圖片。 | 單獨的 MD 檔案無法解析本機相對路徑圖片。 |
| 目錄 | 試試同名標題和程式碼區塊內的標題語法。 | 只有真實標題進入目錄,同名章節擁有不同連結。 |
| 匯出 | 開啟下載的 HTML 並點選目錄連結。 | 目錄定位到副本自身的章節,不包含網站操作欄。 |
開啟和閱讀 MD 檔案的常見問題
怎麼線上開啟 MD 檔案?
點選「開啟檔案」或把 .md 檔案拖到工具中,也可以貼上 Markdown 原文。瀏覽器讀取並呈現文字,不需要安裝桌面軟體。
只想檢視 README.md,不編輯可以嗎?
可以。開啟下載的 README.md 或貼上其原始內容即可,頁面預設以閱讀為主,需要修改時再進入編輯器。
為什麼 README 中的本機圖片沒有顯示?
images/logo.png 等路徑依賴同目錄的其他檔案,單個 MD 檔案不包含這些圖片。請使用內嵌圖片或完整的 HTTPS 地址;外部地址需要開啟圖片載入選項。
手機也可以檢視嗎?
可以。窄屏上目錄會排在正文上方,可從裝置儲存選擇檔案或貼上原始內容。不同手機的檔案選擇器可能顯示不同的檔案型別。
文件會上傳到伺服器嗎?
開啟、渲染、搜尋和 MD/HTML 下載都在瀏覽器內完成。開啟外部圖片會向圖片站點傳送請求;網站本身仍會載入通常使用的統計和廣告服務。
下載 HTML 會帶上搜尋醒目提示嗎?
不會。匯出使用搜尋標記之前的文件內容,可以選擇包含目錄;字型和字級會在匯出支援範圍內沿用閱讀設定。
文件會怎樣被處理
- MD 閱讀、搜尋及 HTML/MD 下載都在本機完成。
- 進入編輯器時臨時使用目前標籤頁的會話儲存,編輯器讀取後會刪除這份傳遞值。
- 外部圖片初始關閉;開啟後請求發往圖片所屬站點,文件渲染仍在瀏覽器中完成。
格式參考CommonMark 入門GitHub Flavored Markdown 規範
反饋可復現的問題請說明瀏覽器、所選設定,並附上不含隱私的最小範例。不要透過郵件傳送私密文件。