跳到主内容
首页博客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 文件查看器