什麼是 Markdown?輕量標記語言的完整說明
快速解答
Markdown 是一種純文字標記語言,它使用簡單的符號來格式化文字:# 表示標題,** 表示粗體,* 表示斜體,- 表示列表,[text](url) 表示連結。它被設計為可讀為純文字並可轉換為 HTML。使用我們免費的 Markdown 到 HTML 轉換器在瀏覽器中呈現 Markdown。
介紹
Markdown 是 John Gruber 在 2004 年創建的輕量級標記語言,它使用純文字格式來產生結構化文件。目標是可讀性——Markdown 原始文字應該看起來像它所代表的那樣,沒有 HTML 標籤的視覺混亂。 Markdown 是 GitHub 上的 README 文件、文件網站、部落格文章、Reddit 和 Stack Overflow 等平台上的評論以及 Obsidian 和 Notion 等筆記應用程式的標準。 Markdown 轉換為 HTML 以進行網路發佈。
步步
-
學習基本文法
標題:# H1、## H2、### H3。粗體:**文字**。斜體:*文字*。清單: - 項目或 1. 項目。連結:[文字](網址)。圖片:。代碼:“內聯”或“塊”。區塊引用:> 引用。水平規則:---。
-
了解哲學
Markdown 被設計為純文字可讀。原始碼應該看起來接近最終渲染的輸出 - **粗體**看起來像粗體,#標題看起來像標題。這與 HTML 形成鮮明對比,其中<strong>粗體</strong>和<h1>標題</h1>在視覺上顯得混亂。
-
了解變體
原始 Markdown(格魯伯的規範)是最小的。 CommonMark 是一個標準化、詳細說明的版本。 GitHub Flavored Markdown (GFM) 新增了表格、刪除線、任務清單和自動連結。 MDX 可讓您在 Markdown 中嵌入 React 元件。大多數工具都支援 GFM。
-
將 Markdown 轉換為 HTML
Markdown 轉換為 HTML 以進行網路發佈。 # Hello 變成 <h1>Hello</h1>,**bold** 變成 <strong>bold</strong>。靜態站點產生器(Astro、Hugo、Jekyll)在建置時轉換 Markdown。使用我們的 Markdown 到 HTML 轉換器進行即時轉換。
範例
標題和段落
輸入: # 標題
一段。
輸出: <h1>Title</h1>
<p>A paragraph.</p>
粗體和斜體
輸入: **粗體**和*斜體*
輸出: <strong>bold</strong> and <em>italic</em>
連結和圖片
輸入: [text](https://example.com) and 
輸出: <a href="https://example.com">text</a> and <img src="image.png" alt="alt">
常見問題
- 換行符號-Markdown 中的單一換行符號不會在 HTML 中建立換行符。在行尾使用兩個空格,或使用兩個換行符號作為段落分隔符號。
- 嵌套列表——縮排很重要。對於嵌套項目,一致使用 2 或 4 個空格;混合它們可能會破壞清單結構。
- 原始 HTML — 大多數 Markdown 解析器都會通過原始 HTML,但有些會對其進行清理。如果直接嵌入 HTML,請檢查解析器的行為。
- 風格不同——Original Markdown、CommonMark 和 GFM 有細微的差別。檢查您的目標平台支援哪種風格。
提示
- 使用 Markdown 進行寫作和文件——它比 HTML 更容易閱讀和編寫。
- GitHub Flavored Markdown (GFM) 是最常見的變體——它添加了表格、刪除線和任務清單。
- 使用 Markdown 編寫並在建立部落格和文件網站時轉換為 HTML。
- 使用我們的 Markdown 到 HTML 轉換器在瀏覽器中立即呈現 Markdown。