技术写作 Help

写作语言:Markdown简洁高效的文本标记语言,技术人的写作利器(扩展语法)

2025 08 05 dc8f886b6e8ccb87713e6a704f001d30

哈喽,各位好!我是“数说编码”,一名工作十多年的程序员。

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

这是介绍Markdown的第二篇,主要介绍Markdown的扩展语法。

第一部分: 扩展语法

Markdown 的基础语法无法满足所有需求,扩展语法应运而生。扩展语法通过添加表格、代码块、脚注等元素来丰富 Markdown 的功能。

(一)表格

使用|分隔列,使用 ---- 定义表头和内容的分隔线

使用 : 来设置内容对齐方式,如: :---- 表示左对齐, ----: 表示右对齐, :----:表示居中对齐

  • 内容对齐示例:

| 左对齐表头 | 居中对齐表头 | 右对齐表头 | |:------ |:------:|-------:| | 1 | 2 | 3 | | 4 | 5 | 6 |

渲染效果如下:

左对齐表头

居中对齐表头

右对齐表头

1

2

3

4

5

6

  • 表格内容使用特殊符号示例:

| Markdown语法 | 渲染效果 | |:-------------:|:---------------:| | `# 一级标题` | <h1> 一级标题 </h1> | | `## 二级标题` | <h2> 二级标题 </h2> | | `### 三级标题` | <h3> 三级标题 </h3> | | `#### 四级标题` | <h4> 四级标题 </h4> | | `##### 五级标题` | <h5> 五级标题 </h5> | | `###### 六级标题` | <h6> 六级标题 </h6> |

渲染效果如下:

Markdown语法

渲染效果

# 一级标题

一级标题

## 二级标题

二级标题

### 三级标题

三级标题

#### 四级标题

四级标题

##### 五级标题

五级标题

###### 六级标题

六级标题

(二)代码块

  • 行内代码 :使用反引号 ` 包裹代码。

python的输出结果如下:`print("Hello, World!")`

渲染效果如下:

python的输出结果如下: print("Hello, World!")

  • 围栏代码块

使用三个反引号 ``` 创建代码块, 在反引号后指定代码语言,可实现语法高亮。

``` json { "name": "数说编程", "age": 22, "gender": "男" } ```

渲染效果如下:

{ "name": "数说编程", "age": 22, "gender": "男" }

(三) 删除线

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

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

渲染效果如下:

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

(四)任务列表

任务列表语法:使用 [ ] 表示未完成, [x] 表示已完成。

- [ ] 未完成的任务 - [x] 已完成的任务(打勾)

渲染效果如下:

  • [ ] 未完成的任务

  • [x] 已完成的任务(打勾)

(五)脚注

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

脚注语法:

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

示例:

[Markdown](https://daringfireball.net/projects/markdown/ "什么是Markdown")在业务开发流程中起到了至关重要的作用。 [Markdown是什么](是一种轻量级的标记语言。 "什么是Markdown")在业务开发流程中起到了至关重要的作用。

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

Markdown在业务开发流程中起到了至关重要的作用。

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

这是效果截图

(六) 使用 Emoji 表情

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

  • 复制并粘贴表情符号:

📝 ⚠️ 🔧

渲染效果如下:

📝 ⚠️ 🔧

  • 使用表情符号简码

:smile: :heart:

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

😄

(七)TOC(Table of Contents)

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

TOC 语法:

[TOC]

渲染效果如下:

[TOC]

(八)注音符号

支持注音符号,用法如下:

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

渲染效果如下:

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

(九)横屏滑动幻灯片

横屏滑动幻灯片语法:

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

< 蓝1, 绿2, 红3 >

第二部分: 变通语法

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

(一) 下划线

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

渲染效果如下:

一些文字 。

(二) 缩进(Tab)

&nbsp;&nbsp;&nbsp;&nbsp;这是一个缩进的段落。

渲染效果如下:

这是一个缩进的段落。

(三) 文字居中

<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">

渲染效果如下:

2025 08 05 dc8f886b6e8ccb87713e6a704f001d30

(七) 图片标题

<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>

渲染效果如下:

  1. 使用图片链接形式(点击图片播放视频):

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

渲染效果如下:

视频预览

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

学习资源

结语

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

本次分享就到这里,咱们下期再见!关注【数说编程】,持续更新技术、写作干货!🚀

如果这篇文章对你有帮助,欢迎关注、点赞、分享和在评论区交流讨论 👇
数说编程

👉 有技术、写作相关问题?欢迎咨询数说编程数字分身
👉 更多干货内容请访问数说编程博客

03 八月 2025