44 lines · 522 chars
Markdown
預覽
編碼與文字
Markdown 預覽
Markdown 預覽就是把你寫的 Markdown 即時渲染成看得懂的頁面 —— 左邊輸入,右邊立刻看到排版結果。這是一個純瀏覽器執行的 Markdown 線上預覽器:可以直接開啟本機 .md 檔,也可以把倉庫裡的 README 貼進來,輸入過程中預覽同步更新。支援 GitHub Flavored Markdown,表格、任務清單、刪除線和程式碼區塊都能正常渲染。你寫的內容不會上傳,也不需要註冊帳號。
你能做什麼
邊寫邊預覽
在左側輸入,右側的排版結果同步更新。沒有單獨的「預覽」按鈕要按,也不用重新整理頁面 —— 這是即時預覽,不是分兩步的渲染。
開啟或拖入 .md 檔
直接在本機讀 Markdown 檔:選擇 .md 檔、拖到編輯區,或者把倉庫裡的 README 複製過來貼上。檔案一載入,預覽立刻出來。
支援 GitHub Flavored Markdown
表格、任務清單、刪除線、自動連結、腳註和圍欄程式碼區塊都按 GitHub 的規則渲染,推上去之前就能看到 README 在 GitHub 上的樣子。
自動產生可點擊的目錄
文件裡的每個標題都會被收集成一份可點擊的大綱,錨點與 GitHub 保持一致。點標題即可跳轉,長 README 不再靠一路往下滾,而是一份能導航的文件。
公式能排版,也能存成 PDF
用美元符號包起來的 LaTeX 公式會由 LaTeX 風格公式 排版 —— 多數 Markdown 站點用的就是它。文件寫好後,列印預覽並從瀏覽器另存為 PDF,文字保持清晰可選取,公式也不會丟。
預設安全,全程本機
Markdown 裡內嵌的原始 HTML 不會被執行,文件無法在你的瀏覽器裡跑腳本。渲染在你自己的裝置上完成:不上傳、不註冊,也不會有檔案副本存在伺服器上。
怎麼用
- 01
把 Markdown 放進編輯區。可以直接輸入、貼上、從本機選擇 .md 檔,或把檔案拖到頁面上。想先看效果的話,範例 README 會自動載入。
- 02
在右側讀渲染結果。輸入時預覽同步更新,標題、表格、清單、連結、公式和程式碼區塊會按發布後的樣子呈現。可以拖動分隔線調整左右寬度,手機上則用「編輯 / 預覽」兩個標籤切換。
- 03
拿走你需要的結果。渲染後的 HTML 可複製到 CMS 或文件頁,原始碼能下載成 .md 檔,也可以點「匯出 PDF」在瀏覽器的列印對話框裡另存為 PDF。用完清空編輯區即可 —— 全程都在你的裝置上完成。
什麼是 Markdown 預覽,什麼時候需要它
Markdown 檔案是什麼
Markdown 檔就是帶少量標點的純文字:兩個井號表示標題,直線表示表格,連字號加兩個空白表示清單項目。檔案本身不攜帶任何格式,所以在任何地方開啟都是純文字。Markdown 預覽做的事,是把這些文字按網頁的方式渲染出來,讓你看到結果而不是原始碼。這個頁面的想法就這麼簡單:.md 檔保持原樣,右側顯示它會變成什麼樣子。
什麼時候需要線上預覽器
人們去找「Markdown 線上預覽器」通常是很實際的原因。你從倉庫裡拉了一份 README,想知道放到自己站點上會是什麼樣 —— 相對路徑的圖片、表格、徽章在 GitHub 之外的行為都不一樣。或者你正在寫 README,想在推送前確認表格能正常渲染。又或者你在別人的電腦上讀一份文件檔,不願意為此安裝任何東西。開啟這個頁面三種情況都能解決:輸入或開啟檔案,看預覽,拿走需要的內容。不用裝外掛,不用加 Node 套件,也不用設定編輯器。
長文件的目錄、公式與 PDF
長文件有兩個額外能力值得知道。標題會被收集成一份可點擊的目錄,錨點 id 與 GitHub 產生的一致,所以章節連結的行為符合預期,五十頁的文件也不再只是一次向下的捲動。文件裡出現數學公式時 —— 用美元符號包起來的那種 —— 會由 LaTeX 風格公式 正式排版,而不是顯示成原始的 LaTeX 原始碼。草稿寫完之後,預覽可以按文件版式列印出來,在瀏覽器裡另存為 PDF,文字依然可選取,公式也不會丟。
使用前先知道的兩點限制
在依賴它之前,有兩點限制值得先知道。第一,預覽遵循 GitHub Flavored Markdown,涵蓋標題、清單、表格、任務清單、刪除線、自動連結、腳註和圍欄程式碼區塊 —— 但它不是完整的發布系統,指向文件外部檔案的引用式連結、自訂 HTML 頁面都不在範圍內。第二,內嵌的 HTML 會按文字渲染而不會執行,圖片按你給的 URL 載入,所以放在磁碟上、和 .md 檔並排的圖片不會自動出現,除非你自己託管或把它嵌成 data URI。在這兩條限制之內,預覽裡看到的就是同一份檔案在相容 GitHub 的渲染器下的產出。
私密、快速、免費
完全在瀏覽器內執行
渲染在你自己的裝置上完成,Markdown 不會上傳,也不會留存副本。
免註冊
開啟就能寫,沒有帳號、登入,也不用裝外掛。
不執行原始 HTML
內嵌 HTML 按文字渲染,文件無法在你的瀏覽器裡跑腳本。
相容 GitHub
支援 GitHub Flavored Markdown,README 推送前的效果先看到。
常見問題
文字差異比較Base64 編碼與解碼JSON 格式化與驗證全部工具返回首頁
有這裡渲染不了的情況?
告訴我們 —— Mermaid 圖表、直接下載 .pdf 檔、匯出 HTML 檔,以及在預覽裡寫批註,是我們收到最多的訴求。