markdown guide beginner tutorial

什麼是 Markdown?初學者的通俗語言指南

Markdown 初學者指南 - 它是什麼、為什麼建立它、在哪裡使用它以及如何立即開始編寫它。無需任何經驗。

W
WordToMD 團隊
·

Markdown 是一種輕量級文本格式化語法,可將純文本轉換為結構化文件。它由 John Gruber 創建於 2004 年,現在已成為文件、自述檔案、部落格文章和開發人員交流的標準格式。本指南解釋了 Markdown 是什麼、人們使用它的原因以及如何開始。

什麼是 Markdown?

Markdown 是一種使用簡單標點符號向純文本新增格式的方法。您在文本編輯器中編寫,Markdown 由處理器呈現為格式化輸出(HTML、PDF 等)。

例如:

# This is a Heading

This is a **bold word** and this is *italic*.

- List item one
- List item two

呈現為:

這是一個標題

這是一個 粗體字 這是 italic.

  • 列出專案一
  • 清單第二項

格式存在於文本本身中 — 沒有隱藏的 XML、沒有二進位制格式、沒有專有編碼。

為什麼建立 Markdown?

在 Markdown 之前,網路編寫者面臨著一個選擇:用原始 HTML 編寫(乏味且容易出錯)或使用生成混亂程式碼的所見即所得編輯器。John Gruber 將 Markdown 設計為:

  1. 按原樣可讀 ——即使沒有渲染, **bold** 讀起來很清楚是強調
  2. 任何人都可寫 — 沒有特殊軟體,只是一個文本編輯器
  3. 可轉換為 HTML — 主要輸出格式

原始規範側重於生成乾淨的 HTML。但 Markdown 此後已傳播到數十種平臺和輸出格式。

Markdown 在哪裡使用?

Markdown 在技術中無處不在:

平臺Markdown 的作用
GitHub自述檔案、問題、拉取請求、wiki
Notion頁面內容和文件
Obsidian保險庫中的所有筆記
WordPress通過 Markdown 外掛釋出
GitBook文件頁面
鬆弛/不和諧訊息格式
堆疊溢位問題與解答
傑基爾/雨果/阿斯特羅部落格文章和靜態頁面
Jupyter 筆記本文件單元

如果您編寫任何技術內容,您幾乎肯定遇到過 Markdown。

Markdown 與 Word:主要區別

方面WordMarkdown
格式二進位制 (.docx)純文本 (.md)
便攜性需要 Word 或相容應用程式在任何文本編輯器中開啟
版本控制困難(二進位制差異)簡單(逐行 Git 差異)
渲染內置於應用程式中需要 Markdown 渲染器
學習曲線所見即所得(無需學習)需要學習語法
平臺支援微軟生態系統通用開發者工具

如果您想要將 Word 文件轉換為 Markdown, WordToMD 可以立即處理此問題 - 無需註冊,無需上傳。

基本 Markdown 語法

以下是最常見的元素:

標題

# Heading 1
## Heading 2
### Heading 3

見 Markdown 標題指南 完整參考。

強調

**Bold text**
*Italic text*
~~Strikethrough~~

列表

- Unordered item
- Another item
  - Nested item

1. First
2. Second
3. Third
[Link text](https://example.com)

影像

![Alt text](image.png)

程式碼

Inline: `code snippet`

Block:
```python
print("Hello, Markdown!")

See [Markdown Code Blocks Guide](/blog/markdown-code-blocks-guide).

### Tables

```markdown
| Name | Role |
|---|---|
| Alice | Developer |
| Bob | Designer |

見 Markdown 表:完整指南.

塊引用

> This is a blockquote.
> It can span multiple lines.

Markdown口味

“Markdown”不是單一標準——有多種變體:

  • CommonMark — 嚴格、明確的規範
  • GitHub 風格的 Markdown (GFM) — CommonMark + 表格、任務列表、刪除線、自動連結
  • 多重 Markdown — 新增腳註、引文、後設資料
  • Pandoc Markdown — 功能最豐富,由 Pandoc 轉換器使用

大多數平臺至少支援 CommonMark。GitHub、Obsidian 和 GitBook 使用 GFM。如需完整參考,請參閱 Markdown 語法速查表.

如何編寫 Markdown

您不需要特殊的軟體。選項包括:

  • VS 程式碼 — 免費、強大的編輯器,帶有內建 Markdown 預覽
  • Obsidian — 帶圖表檢視的 Markdown 筆記應用程式
  • Typora — 所見即所得 Markdown 編輯器
  • iA 作家 — 專注的寫作環境
  • 任何純文本編輯器 — 記事本、文本編輯、vim、emacs

Markdown 和其他格式之間的轉換

如果您有 Word 文件要轉換為 Markdown, WordToMD 只需幾秒鐘即可完成 — 完全免費,無需上傳檔案。

相反(Markdown 到 Word 或 PDF),Pandoc 等工具可以處理此轉換。參見 Pandoc Word到 Markdown 設定說明。

FAQ

Markdown 是一種程式語言嗎? 不。Markdown 是一種標記語言——它描述格式,而不是邏輯或計算。

我可以在 Microsoft Word 中使用 Markdown 嗎? Word 本身並不呈現 Markdown,但有一些 Word 載入項添加了 Markdown 支援。或者,將 Word 轉換為 Markdown WordToMD 並使用 Markdown 編輯器。

Markdown 適合長文件嗎? 是的,具有良好的標題結構。非常長的文件受益於分割成多個檔案(如在 GitBook 或 ObsidianVault 中)。

Markdown 使用什麼副檔名? .md 是標準。 .markdown 也有效。一些平臺使用 .mdx 適用於帶有 JSX (React) 元件的 Markdown。

結論

Markdown 是一種簡單而強大的格式,已成為技術寫作的通用語言。它可以作為純文本閱讀,呈現精美,並且可以與每個主要的開發工具配合使用。如果您是新手,請從 Markdown 語法速查表 並嘗試轉換您的第一個 Word 文件 WordToMD.