當然可以。Markdown 就是純文字,而純文字自 Unicode 以來就完整支援多語言。中文、日文、韓文在每個語法元素裡都能用,沒有例外:標題、清單、表格、引用、連結文字、圖片替代文字、程式碼區塊、註腳。整個網站就是證明,這裡的每篇指南都有繁體中文版,而且每一篇都是用 Markdown 寫的。

需要注意的只有一件事,而且幾乎每個人都會中招一次:標點的全半形。語法符號本身必須是半形 ASCII,即使前後的中文內文滿是全形標點也一樣。做對這一點,中日韓文字就沒有其他要特別處理的地方了。

重點速覽

標題可以用中文嗎可以。# 前言 就是標題,井字號後面要接半形空格
連結文字可以用中文嗎可以。只有外面的方括號與圓括號必須是半形
全形標點的地雷()[]| 會破壞連結、圖片與表格語法;內文標點則完全無害
字數怎麼算中日韓文字一字算一個字,英文則以空格分詞計算
字型顯示由讀者的裝置與 CSS 決定,永遠不會存在 .md 檔裡

中日韓文字在每個元素裡都能用

重點摘要
  • 中日韓文字在每個 Markdown 元素裡都能用,沒有任何開關要打開。
  • 語法符號如 [ ] ( ) | # 一律要用半形 ASCII。
  • 內文標點如 。,「」 維持全形就好,不會破壞任何語法。
  • 粗體夾在兩個中文字中間不生效時,改用 <strong> 即可。

每一種元素都吃中文

不需要開啟任何特殊模式,也不需要改編碼設定。# 前言 就是標題,**重點** 就是粗體,- 第一項 就是清單項目。表格儲存格放 | 台北 | 2,600,000 | 和放英文一樣自然,程式碼區塊也會逐位元組保留中文註解。下面是一份幾乎用上所有語法的實際文件:

# 專案說明

## 安裝步驟
1. 下載安裝檔
2. 執行 `setup.exe`
3. 重新啟動電腦

| 城市 | 人口 | 面積(平方公里) |
| --- | ---: | ---: |
| 台北 | 2,600,000 | 271.8 |
| 台中 | 2,800,000 | 2,214.9 |

詳見[官方文件](https://example.com/docs),或參考附錄 A。

語法半形,內文全形

看清楚哪些是半形、哪些不是。#1.、反引號、直線、對齊列的連字號、讓數字欄靠右的冒號,以及連結的方括號和圓括號,全部都是 ASCII。夾在它們裡面的內容全是中文,包括表頭儲存格「面積(平方公里)」裡那對全形圓括號,那是純內文,解析器根本不會去碰。

唯一的地雷:全形標點

輸入法停在中文模式時打出來的標點,外觀幾乎一樣,卻會被當成普通文字。下面兩行都不會生效:

#前言
[說明文件](https://example.com)

把語法符號換成半形之後,兩行都正常了,其他一個字都沒改:

# 前言
[說明文件](https://example.com)

注意:在一般字級下,這兩個版本看起來幾乎沒有差別。所以連結、圖片或表格怎麼樣都不出來時,先檢查標點的全半形,再去找其他原因。

還有一個細節值得知道:** 這類強調符號夾在中日韓字元中間、前後沒有詞界時偶爾會失效,因為解析器判斷不出「單字」的界線。句子中間的粗體怎麼樣都不出來時,改用 <strong>重點</strong> 保證有效。完整指南裡的每個範例,把英文換成中文照樣成立。

插圖:一份 Markdown 文件同時使用中文字與半形 ASCII 語法符號,兩種字寬並列對照

哪些字元必須用半形

界線其實很簡單:解析器當成指令讀的字元必須是 ASCII,被它當成文字的字元則想用哪一國的標點都可以。

字元在 Markdown 裡的角色要求的字寬打成全形會怎樣
#標題階層只能半形#前言 會維持成普通段落
[ ]連結與圖片的標籤只能半形[連結] 的方括號會原樣顯示出來
( )連結與圖片的目標只能半形網址會直接印出來,不會變成連結
!圖片前綴只能半形圖片不會嵌入,最多只變成連結
|表格的欄位分隔只能半形整列會被渲染成一行文字
- * +清單項目、分隔線只能半形該行維持成普通段落
`行內程式碼與圍欄只能半形程式碼不會等寬,還可能被重新排版
>引用區塊只能半形不會出現引用樣式
符號後的空格分隔符號與文字半形空格,不是 U+3000全形空格可能讓標題或清單無法成立
。,、;:!?內文標點全形才正確沒事。解析器根本不看這些
「」『』內文引號全形才正確沒事
內文裡的()內文的圓括號全形正確且更好看沒事,只要它包的不是網址

小提醒:打連結或表格那一兩秒,把輸入法切到英文模式,打完再切回來。用工具列按鈕則能徹底繞過這個問題,因為按鈕插入的一定是 ASCII,跟你當下的輸入模式無關。

壞掉的寫法與修正方式

下面四種失敗幾乎涵蓋了所有「我的 Markdown 寫中文就不會動」的案例,每一個都先給壞掉的寫法,再給修正版。

1. 連結用了全形括號

壞掉:  [連結文字](https://example.com)
正確:  [連結文字](https://example.com)

方括號中間的文字要寫什麼中文都隨你,必須改的只有外面那四個字元。圖片語法規則相同,而且開頭的 ! 也必須是半形。

2. 表格用了全形直線

壞掉:  | 城市 | 人口 |
正確:  | 城市 | 人口 |

下面那列對齊列也必須用半形連字號:| --- | --- |。表格是這裡最常壞掉的元素,完整語法請看表格指南

3. 符號後面接了全形空格

這個看不見,所以特別惱人。# 後面接的如果是 U+3000 而不是一般空格,標題可能根本不會成立。標題怎麼樣都不出來、井字號看起來又沒問題時,把那個空格刪掉重打一次。

4. 粗體被中文字夾住

這是**重點**內容 有時候會把星號原樣印出來,因為解析器找不到可以依附的詞界。兩個修法都有效:在符號旁邊加一個空格或標點,或者直接用 <strong>重點</strong>,這個永遠不會失敗。

四種問題的診斷方法都一樣:把文字貼進編輯器,盯著預覽看,沒生效的語法同一秒就看得出來。

字數統計與中日韓文字

為什麼用空格分詞會失效

英文工具那種「以空格切分計算單字數」的做法,對中文完全失效:一段五百字的中文一個空格都沒有,會被回報成一個「單字」。編輯器的計數器正確處理了這件事:

  • 中日韓文字按字元計算,符合中文實際使用的「字數」概念。
  • 同一份文件裡的英文單字,仍然以空格分詞計算。
  • 兩種數字合併加總,中英夾雜的文件才會得到有意義的總數。

這個數字為什麼重要

這件事的重要性超乎想像。中文的投稿字數上限、作業長度、客戶需求全都以字數表達,所以一個把整頁內容報成「一個字」的工具不只是不準,而是根本不能用。粗略的換算比例是:一篇一千字的英文文章,中文版通常落在一千五到兩千字之間。

中英夾雜怎麼寫才乾淨

三個讓版面乾淨的慣例

雙語文件正是 Markdown 默默發揮實力的地方,因為格式本身不會干擾任何一種語言。三個習慣就能讓成果保持整齊:

  • 夾雜的英文左右加空格。寫成「使用 VS Code 編輯」,多數台灣的排版指南都這麼建議,可讀性立刻提升。
  • 程式碼、網址、檔名、版號放進行內程式碼。這樣 `config.json` 在中英文之間都清楚可辨。
  • 標點一句話用一套。中文句子裡用全形、英文句子裡用半形,逗號和引號才不會在同一行裡打架。

中英對照要怎麼排

需要兩種語言同時出現時,用兩欄表格比一段中文一段英文交替更乾淨,因為文件變長時對應關係仍然對得整齊。若兩種語言各自發成獨立頁面,請讓兩邊的標題結構完全一致:翻譯審稿會輕鬆很多,錨點連結也能在兩個版本之間保持一致,本站的雙語頁面就是這樣做的。

相關問題

立即使用編輯器

開啟編輯器