Markdown、Mermaid 與 LaTeX

技術文件、Wiki、部落格與筆記工具(HackMD、Notion、GitHub、本 Wiki)大多支援 Markdown 作為主要寫作格式。進階內容常搭配 Mermaid 畫圖、LaTeX 寫數學公式。本篇說明三者各自做什麼、怎麼寫、以及在本站如何呈現。 Markdown Markdown 是一種輕量標記語言:用純文字加上簡單符號(#、*、` 等)描述格式,再由編輯器或網站轉成 HTML 顯示。 為什麼要用 Markdown? 優點 說明 純文字 可用 Git 版控、diff、搜尋 語法簡單 比 HTML 少很多標籤 跨平台 HackMD、VS Code、WordPress 外掛、靜態網站產生器皆支援 專注內容 先寫結構與文字,樣式交給主題 CSS 常用語法速查 標題 強調與行內程式碼 清單 連結與圖片 引用與分隔線 表格 程式碼區塊 以三個反引號包住,並可標註語言以啟用語法高亮: Markdown 的局限 Mermaid Mermaid 用「類 Markdown 的文字語法」描述圖表,由瀏覽器或建站工具即時渲染成 SVG。適合放在文件裡說明流程、架構、時序,而不必另外開 draw.io 匯出圖片。 基本寫法 在 Markdown 程式碼區塊標註 … Continue reading Markdown、Mermaid 與 LaTeX