當然可以。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> 保證有效。完整指南裡的每個範例,把英文換成中文照樣成立。
哪些字元必須用半形
界線其實很簡單:解析器當成指令讀的字元必須是 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`在中英文之間都清楚可辨。 - 標點一句話用一套。中文句子裡用全形、英文句子裡用半形,逗號和引號才不會在同一行裡打架。
中英對照要怎麼排
需要兩種語言同時出現時,用兩欄表格比一段中文一段英文交替更乾淨,因為文件變長時對應關係仍然對得整齊。若兩種語言各自發成獨立頁面,請讓兩邊的標題結構完全一致:翻譯審稿會輕鬆很多,錨點連結也能在兩個版本之間保持一致,本站的雙語頁面就是這樣做的。
相關問題
立即使用編輯器
開啟編輯器