今天我们来聊聊每个程序员都应该掌握的技能——Markdown。

在掌握了Markdown基础语法之后，我们可以进一步学习扩展语法来丰富文档的表现力。本文将详细介绍Markdown的扩展语法和变通技巧，协助你创建更专业、更美观的技术文档。

第一部分: 扩展语法

Markdown 的基础语法无法满足所有需求，扩展语法应运而生。

⚠️ 提示： 不同平台对扩展语法的支持程度不同，使用前请确认目标平台是否支持

（一） 删除线

请在单词前后使用两个波浪号 ~~ 。

会议时间：~~下午3点~~ → 上午10点

渲染效果如下:

会议时间：下午3点 → 上午10点

（二）任务列表

任务列表语法：使用 [ ] 表明未完成，[x] 表明已完成。

- [ ] 未完成的任务
- [x] 已完成的任务（打勾）

渲染效果如下:

• 未完成的任务
• 已完成的任务（打勾）

（三）脚注

脚注是文档中用于提供补充信息或引用来源的一种标记方式。在 Markdown 中，脚注允许你为文档中的特定内容添加详细说明或参考资料，而不会打断正文的阅读流程。

脚注语法：

[文字](脚注解释 "脚注名字")

示例：

[Markdown](https://daringfireball.net/projects/markdown/ "什么是Markdown")在业务开发流程中起到了至关重大的作用。

[Markdown是什么](是一种轻量级的标记语言。 "什么是Markdown")在业务开发流程中起到了至关重大的作用。

渲染效果如下:： 请拉到最下面观看

Markdown[1]在业务开发流程中起到了至关重大的作用。

Markdown是什么[2]在业务开发流程中起到了至关重大的作用。

（四） 使用 Emoji 表情

两种添加表情方式：复制粘贴或使用简码。

⚠️ 提示：

表情符号简码仅在特定平台支持，提议优先使用复制粘贴法 我整理了一份常用的表情符号简码表，请自行查看。 常用资源： Emojipedia[3] - 表情符号搜索引擎 表情简码表[4] - 简码参考

• 复制并粘贴表情符号：

  ⚠️  

渲染效果如下:

⚠️

• 使用表情符号简码

:smile:  
:heart:

渲染效果如下: （部分markdown编辑器渲染不出来）

:smile:
:heart:

（五）TOC（Table of Contents）

TOC 是自动生成目录的功能，会根据文档标题层级创建导航目录。

TOC 语法：

[TOC]

渲染效果如下:

[TOC]

（六）注音符号

支持注音符号，用法如下：

欢迎关注我的公众号，{数说编程|shù shuō biān chéng}！

渲染效果如下:

欢迎关注我的公众号，{数说编程|shù shuō biān chéng}！

（七）横屏滑动幻灯片

横屏滑动幻灯片语法：

<![](url),![](url)>

<

,

,

>

第二部分: 变通语法

我们除了能使用扩展语法，还可以使用 HTML 变通方法实现特殊效果。

⚠️ 注意：HTML标签兼容性因平台而异

（一） 下划线

一些文字 <ins>将被加下划线</ins>。

渲染效果如下:

一些文字 将被加下划线。

（二） 缩进（Tab）

    这是一个缩进的段落。

渲染效果如下:

这是一个缩进的段落。

（三） 文字居中

<p style="text-align:center">这段文字居中显示。</p>

渲染效果如下:

这段文字居中显示。

（四） 文字颜色

<font color="red">这段文字是红色的！</font>
<p style="color:blue">这段文字是蓝色的。</p>

渲染效果如下:

这段文字是红色的！

这段文字是蓝色的。

（五） 隐藏注释

这是可见的段落。

[这是一个隐藏的注释]: #

这是另一个可见的段落。

渲染效果如下:

这是可见的段落。

这是另一个可见的段落。

（六） 调整图片大小

<img src="https://numerocode.top/numerocode-img/2025-08-05-dc8f886b6e8ccb87713e6a704f001d30.png" width="200" height="100">

渲染效果如下:

（七） 图片标题

<figure>
    <img src="https://numerocode.top/numerocode-img/2025-08-05-dc8f886b6e8ccb87713e6a704f001d30.png" alt="描述文本">
    <figcaption>这是一张描述图片。</figcaption>
</figure>

渲染效果如下:

这是一张描述图片。

（八） 新标签打开链接

Markdown 不能指定 target="_blank"，但 HTML 可以：

<a href="https://www.baidu.com" target="_blank">百度一下！</a>

（九） 插入视频

有两种插入视频的方式：

1. 使用 iframe 标签插入视频：

<iframe src="视频嵌入链接" width="560" height="315" frameborder="0" allowfullscreen></iframe>

渲染效果如下:

2. 使用图片链接形式（点击图片播放视频）：

[![视频预览](预览图片地址)](视频播放地址)

渲染效果如下:

Markdown 作为轻量级标记语言，有必定的局限性，但借助 HTML 和 CSS，可以实现许多 Markdown 不支持的功能。希望这些技巧能协助你更高效地使用Markdown！

第三部分: 数哥私藏资料推荐

学习资源

• Markdown官方语法[6] - 最权威的资料
• Markdown语法教程[7] - 详细全面的中文教程
• Markdown菜鸟教程[8] - 适合初学者的入门教程

第四部分: 考考你

如何在markdown中输入拼音？

列如：shù shuō biān chéng

结语

Markdown这东西，说重大吧也不是核心技能，但说不重大吧，真能提升你的写作效率。掌握这个工具，能让你的技术写作之路顺畅不少。

引用链接

[1]Markdown: https://daringfireball.net/projects/markdown/

[2]Markdown是什么: 是一种轻量级的标记语言。

[3]Emojipedia: https://emojipedia.org/

[4]表情简码表:
https://gist.github.com/rxaviers/7360908

[5]:测试视频：
https://numerocode.top/numerocode-img/video/PixPin_2025-08-10_13-35-50.mp4

[6]Markdown官方语法:
https://daringfireball.net/projects/markdown/syntax

[7]Markdown语法教程:
https://markdown.com.cn/basic-syntax/

[8]Markdown菜鸟教程:
https://www.runoob.com/markdown/md-tutorial.html