Markdown 語法指南

完整 Markdown 語法參考,輕鬆編寫格式優美的文檔

Markdown 是一種輕量級標記語言,讓你用簡單符號標註文件格式。語法直觀簡潔,學習容易,很適合用於技術文件、部落格、筆記。本指南全面涵蓋 MarkPDF 支援的 Markdown 語法。

標題

以 # 渲染標題。# 數量代表層級,從 H1 到 H6 共六級

Markdown
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
渲染效果
<h1>Heading 1</h1>
<h2>Heading 2</h2>
<h3>Heading 3</h3>
<h4>Heading 4</h4>
<h5>Heading 5</h5>
<h6>Heading 6</h6>

段落與換行

段落間空一行分隔。若段內換行,在行尾加兩個空格後按 Enter

Markdown
This is paragraph one.

This is paragraph two.

Line one with two spaces at end  
Line two (soft break)
渲染效果
<p>This is paragraph one.</p>
<p>This is paragraph two.</p>
<p>Line one with two spaces at end<br>
Line two (soft break)</p>

強調

星號或底線包覆文字可套用強調效果

Markdown
*Italic* or _italic_
**Bold** or __bold__
***Bold and italic***
~~Strikethrough~~
渲染效果
<em>Italic</em>
<strong>Bold</strong>
<strong><em>Bold and italic</em></strong>
<del>Strikethrough</del>

清單

支援有序、無序與巢狀清單

Markdown
Unordered list:
- Item 1
- Item 2
  - Nested item
  - Another nested

Ordered list:
1. First
2. Second
3. Third
渲染效果
<ul>
<li>Item 1</li>
<li>Item 2
  <ul>
  <li>Nested item</li>
  <li>Another nested</li>
  </ul>
</li>
</ul>
<ol>
<li>First</li>
<li>Second</li>
<li>Third</li>
</ol>

程式碼

反引號標註行內程式碼,三個反引號建立程式區塊

Markdown
Inline `code` in text.

```javascript
function hello() {
  console.log("Hello!");
}
```
渲染效果
<code>code</code>
<pre><code class="language-javascript">
function hello() {
  console.log("Hello!");
}
</code></pre>

表格

以豎線和橫線製作表格,支援對齊設定

Markdown
| Header 1 | Header 2 | Header 3 |
|----------|:--------:|---------:|
| Left     | Center   | Right    |
| Cell     | Cell     | Cell     |
渲染效果
<table>
<thead><tr>
<th>Header 1</th>
<th align="center">Header 2</th>
<th align="right">Header 3</th>
</tr></thead>
<tbody>
<tr><td>Left</td><td>Center</td><td>Right</td></tr>
<tr><td>Cell</td><td>Cell</td><td>Cell</td></tr>
</tbody>
</table>

引言

用 > 標註引用,可巢狀使用

Markdown
> This is a blockquote.
> It can span multiple lines.
>
> > Nested blockquote
渲染效果
<blockquote>
<p>This is a blockquote.
It can span multiple lines.</p>
<blockquote><p>Nested blockquote</p></blockquote>
</blockquote>

水平線

用三條以上的橫線、星號或底線分隔內容

Markdown
---
***
___
渲染效果
<hr>

跳脫字元

反斜線可跳脫特殊字元並當做一般字顯示

Markdown
\*Not italic\*
\# Not a heading
\[Not a link\]
渲染效果
*Not italic*
# Not a heading
[Not a link]