chore: update i18n md style guide articles

This commit is contained in:
radishzzz 2025-03-24 21:27:36 +00:00
parent ece7351668
commit e3730749de
8 changed files with 424 additions and 300 deletions

View file

@ -8,32 +8,54 @@ lang: zh-tw
abbrlink: markdown-style-guide
---
以下是一些基本的 Markdown 語法示例,可以在 Retypeset 主題中使用
以下是一些基本的 Markdown 語法示例,以及在 Retypeset 主題中的樣式效果
## 標題
HTML 的 `<h1>``<h6>` 標籤對應六個等級的標題。`<h1>` 為最高級標題,`<h6>` 為最低級。
在文字前添加井號 `#` 與空格,即可創建標題。井號數量對應標題等級。
### 語法
```
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
```
### 效果
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
## 段落
使用空行分隔文字,即可創建段落。
### 語法
```
孔乙己一到店,所有喝酒的人便都看著他笑,有的叫道:"孔乙己,你臉上又添上新傷疤了!"他不回答,對櫃裡說:"溫兩碗酒,要一碟茴香豆。"便排出九文大錢。他們又故意的高聲嚷道:"你一定又偷了人家的東西了!"孔乙己睜大眼睛說:"你怎麼這樣憑空污人清白……""什麼清白?我前天親眼見你偷了何家的書,吊著打。"孔乙己便漲紅了臉,額上的青筋條條綻出,爭辯道:"竊書不能算偷……竊書!……讀書人的事,能算偷麼?"接連便是難懂的話,什麼"君子固窮",什麼"者乎"之類,引得眾人都哄笑起來:店內外充滿了快活的空氣。
聽人家背地裡談論,孔乙己原來也讀過書,但終於沒有進學,又不會營生;於是愈過愈窮,弄到將要討飯了。
```
### 效果
孔乙己一到店,所有喝酒的人便都看著他笑,有的叫道:"孔乙己,你臉上又添上新傷疤了!"他不回答,對櫃裡說:"溫兩碗酒,要一碟茴香豆。"便排出九文大錢。他們又故意的高聲嚷道:"你一定又偷了人家的東西了!"孔乙己睜大眼睛說:"你怎麼這樣憑空污人清白……""什麼清白?我前天親眼見你偷了何家的書,吊著打。"孔乙己便漲紅了臉,額上的青筋條條綻出,爭辯道:"竊書不能算偷……竊書!……讀書人的事,能算偷麼?"接連便是難懂的話,什麼"君子固窮",什麼"者乎"之類,引得眾人都哄笑起來:店內外充滿了快活的空氣。
聽人家背地裡談論,孔乙己原來也讀過書,但終於沒有進學,又不會營生;於是愈過愈窮,弄到將要討飯了。
## 圖片
使用感嘆號 `!` 方括號 `[]` 與圓括號 `()`,即可添加圖片。這些符號都是英文半形符號,而非中文全形符號。
### 語法
```markdown
@ -46,57 +68,67 @@ HTML 的 `<h1>` 至 `<h6>` 標籤對應六個等級的標題。`<h1>` 為最高
## 區塊引用
區塊引用標籤表示從外部引用的內容,可以使用 `footer``cite` 標籤標註內容來源,也可以在區塊引用中使用 `<mark>``<abbr>` 等標籤
在段落前添加 `>` 符號和空格,即可創建區塊引用。在段落間的空行添加 `>` 符號,即可包含多個段落。若需標註引用來源,可使用 `<cite>``<footer>` 標籤添加文獻來源,同時可通過 `[^1]``[^note]` 格式插入腳註
### 未標註內容來源
### 多個段落
#### 語法
```markdown
> 天地不仁,以萬物為芻狗。<br>
> 天地不仁,以萬物為芻狗。
>
> **提示**:引用區塊內可使用 _Markdown 語法_
```
#### 效果
> 天地不仁,以萬物為芻狗。<br>
> 天地不仁,以萬物為芻狗。
>
> **提示**:引用區塊內可使用 _Markdown 語法_
### 標註內容來源
### 標註引用來源
#### 語法
```markdown
> 在我的後園,可以看見牆外有兩株樹,一株是棗樹,還有一株也是棗樹。<br>
> 在我的後園,可以看見牆外有兩株樹,一株是棗樹,還有一株也是棗樹。
>
> —— <cite>《秋夜》[^1]</cite>
[^1]: [《秋夜》](https://zh.wikisource.org/wiki/%E7%A7%8B%E5%A4%9C_(%E9%AD%AF%E8%BF%85)) 是魯迅散文詩集《野草》中的第一首散文詩創作於1924年。
```
#### 效果
> 在我的後園,可以看見牆外有兩株樹,一株是棗樹,還有一株也是棗樹。<br>
> 在我的後園,可以看見牆外有兩株樹,一株是棗樹,還有一株也是棗樹。
>
> —— <cite>《秋夜》[^1]</cite>
[^1]: [《秋夜》](https://zh.wikisource.org/wiki/%E7%A7%8B%E5%A4%9C_(%E9%AD%AF%E8%BF%85)) 是魯迅散文詩集《野草》中的第一首散文詩創作於1924年。
## 表格
使用三個或多個連字符 `---` 分隔標題,並使用管道符 `|` 分隔每列,即可創建表格。
### 語法
```markdown
| 斜體 | 粗體 | 程式碼 |
| ------- | -------- | ------- |
| _斜體_ | **粗體** | `程式碼` |
| 斜體 | 粗體 | 程式碼 |
| ----- | -------- | ------- |
| _斜體_ | **粗體** | `程式碼` |
| _斜體_ | **粗體** | `程式碼` |
```
### 效果
| 斜體 | 粗體 | 程式碼 |
| ------- | -------- | ------- |
| _斜體_ | **粗體** | `程式碼` |
| 斜體 | 粗體 | 程式碼 |
| ------ | ------- | ------- |
| _斜體_ | **粗體** | `程式碼` |
| _斜體_ | **粗體** | `程式碼` |
## 程式碼區塊
在程式碼的開頭和結尾處,添加三個反引號 ``` 來創建程式碼區塊。在開頭的反引號後標註語言類型,例如 html、javascript、css、markdown 等,以實現語法高亮效果
在程式碼的頂部與底部添加三個反引號 ```` ``` ````,即可創建程式碼區塊。在頂部的反引號後標註語言類型,例如 html、javascript、css、markdown 等,即可實現語法高亮
### 語法
@ -154,14 +186,14 @@ HTML 的 `<h1>` 至 `<h6>` 標籤對應六個等級的標題。`<h1>` 為最高
```markdown
- 列表項
- 另一
- 圖表
- 更多項
```
#### 效果
- 列表項
- 另一
- 圖表
- 更多項
### 嵌套列表