跳到主內容
首頁部落格Markdown 底線:GitHub 與其他渲染器的支援情況

Markdown 底線:GitHub 與其他渲染器的支援情況

Markdown 沒有原生底線語法。瞭解 <ins> 和 <u> 何時有效、為什麼 __text__ 是粗體,以及如何選擇更通用的替代方式。

發布於:

Markdown 沒有為文字新增底線的原生語法。 在 CommonMark 和 GitHub Flavored Markdown 中,_文字_ 表示斜體,__文字__ 表示粗體。底線通常需要 HTML 支援或應用專屬擴充功能。

GitHub 文件給出的寫法是:

<ins>修訂後的截止日期</ins>是星期五。

GitHub 在基本格式文件中列出 <ins>...</ins> 用於底線文字。這是平臺支援的 HTML 選項,並非在所有地方都適用的新 Markdown 分隔標記。

底線、粗體與斜體對比

原始碼 含義 適用範圍
_重要_ 強調,通常顯示為斜體 CommonMark 和 GFM
__重要__ 強烈強調,通常顯示為粗體 CommonMark 和 GFM
**重要** 強烈強調,通常顯示為粗體 CommonMark 和 GFM
<ins>新增文字</ins> 插入的文字,通常帶底線 啟用 HTML 的渲染器;GitHub 文件明確支援
<u>批註文字</u> HTML 批註,通常帶底線 允許此 HTML 元素的渲染器

如果目的是強調,請選擇粗體或斜體。例如,**星期五截止** 在 README、筆記和 Markdown 匯出文件中都能使用,不依賴原始 HTML。

ins 與 u 有什麼區別?

這兩個標籤看起來可能相似,但含義不同。

<ins> 表示插入文件的文字,適合新增要求等修訂內容。瀏覽器通常會為它加底線,但樣式表可以改變這種外觀。參閱 MDN 插入文字參考

此版本支援<ins>匯入 CSV 和 TSV</ins>

<u> 表示不同於普通強調的批註,例如標記拼寫錯誤。現代 HTML 並未將它定義為通用的“突出重要內容”標籤。參閱 MDN u 元素參考

請檢查 <u>recieve</u> 的拼寫。

如果你能控制網站,並且只需要視覺上的底線,可以透過 CSS 應用 text-decoration: underline。託管式 Markdown 平臺可能移除樣式屬性或禁止自訂樣式,因此這種方式也不具備通用可移植性。

為什麼底線在一個編輯器中有效,在另一個中卻消失?

這裡涉及三個獨立決定:Markdown 解析器識別 HTML,應用選擇允許哪些標籤,目標位置的樣式表決定這些元素如何顯示。支援 GFM 並不保證產品允許所有 HTML 標籤。

MD File Viewer 編輯器目前會移除使用者輸入中的原始 HTML 標籤。貼上 <ins>新增文字</ins><u>批註文字</u> 後,文字會保留,但標籤會被移除,因此預覽不會顯示底線。請用該預覽檢查受支援的 Markdown 格式,並在實際發布位置驗證基於 HTML 的格式。

如果要將 HTML 文件遷移為 Markdown,HTML 轉 Markdown 轉換器可以幫助恢復文字、標題、連結和列表。底線與自訂 CSS 可能丟失,因為純 Markdown 沒有對應語法。替換原始文件前,請檢查結果。

GitHub README 範例

對於更新說明中的一小段新增內容,GitHub 文件給出的 HTML 選項是:

此版本新增<ins>可選的匯入步驟</ins>

對於截止日期或要求,請使用 Markdown 強調:

**必需:** CSV 檔案中應包含表頭列。

對於目標位置,請使用連結:

[閱讀匯入說明](https://example.com/import)

帶底線的文字可能看起來像可點選連結。避免讓普通標籤顯得可以互動,尤其是同一段落還包含真實連結時。Markdown 連結指南介紹了描述性連結文字和引用式連結。

常見底線錯誤

雙底線會把文字變成粗體。**詞語** 改為 __詞語__ 只是改變分隔標記,不會改變含義。兩者都表示強烈強調。

反引號會把標籤顯示為程式碼。 `<ins>文字</ins>` 適合教程範例,但這種寫法有意顯示標記,而不是渲染它。

鍵盤快捷鍵屬於應用功能。 富文字編輯器可能提供底線命令,並儲存 HTML 或自身的文件格式。這不代表底線成為了可移植 Markdown 的一部分。

帶底線式標記的標題是另一回事。 在下面的原始碼中,連字元會生成二級標題:

更新說明
-------------

它們不會為段落中的短語加底線。要分隔章節,請使用 Markdown 水平線,並在上下保留空行。

常見問題

如何在 GitHub 的 Markdown 中新增底線?

使用 GitHub 文件列出的 <ins>文字</ins>。如果希望強調格式也能在不支援 HTML 的渲染器中使用,請改用 **文字***文字*

有僅使用 Markdown 的底線替代語法嗎?

沒有標準底線分隔標記。有些應用新增了自己的語法,但你需要檢查其文件以及匯出時使用的格式。

轉換為 PDF 或 Word 後,底線會保留嗎?

只有轉換器保留相關 HTML 或擴充功能,並支援其樣式時才會保留。不要假設在一個應用的預覽中可見的底線會在另一個匯出工具中繼續存在。請檢查生成的檔案,或在重視可移植性時使用標準粗體強調。

Markdown 速查表簡要介紹了具有專用 Markdown 語法的格式。

在瀏覽器中試試

開啟首頁編輯器,即可免安裝地檢視、編輯和匯出 Markdown。

更多文章

Markdown 底線:GitHub 與其他渲染器的支援情況 | MD 檔案檢視器