1Tools

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 不會被執行,文件無法在你的瀏覽器裡跑腳本。渲染在你自己的裝置上完成:不上傳、不註冊,也不會有檔案副本存在伺服器上。

怎麼用

  1. 01

    把 Markdown 放進編輯區。可以直接輸入、貼上、從本機選擇 .md 檔,或把檔案拖到頁面上。想先看效果的話,範例 README 會自動載入。

  2. 02

    在右側讀渲染結果。輸入時預覽同步更新,標題、表格、清單、連結、公式和程式碼區塊會按發布後的樣子呈現。可以拖動分隔線調整左右寬度,手機上則用「編輯 / 預覽」兩個標籤切換。

  3. 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 檔,以及在預覽裡寫批註,是我們收到最多的訴求。

傳送回饋