简洁高效的文本标记语言，技术人的写作利器之基础语法介绍

今天我们谈谈每一个软件开发者和技术作者都应当学会的一项本领——。

现在资讯泛滥的社会里，我们每天都要面对和整理海量文字资料。无论是编辑报告、发表随笔，还是在社区里表达看法，找到便捷的文字处理方法非常关键。这种简易的格式化工具因此出现，凭借其鲜明特点获得了广泛认同。

「」一种用符号代替排版的写作方式，通过简单符号就能实现：

第一部分: 简介（一）是啥玩意儿？

它是一种简便的标注语言，可以用简明清晰的文本形式记录内容，之后转换成符合规范的HTML代码（或不同类型的数据）。

这件东西由John大神所创，旨在帮助创作者专心致志于文本核心，无需再为版面布局而烦忧。

个人觉得，这玩意儿简直就是为咱们程序员量身定做的写作工具。

（二）为什么要用？Word它不香吗？

大约很多人起初和我相似，认为Word、WPS这类内容编辑工具相当不错，不明白为何要费心研究其他选项，

有段时间，我从事技术文档编写工作，却遭遇了 的难题，费了半小时才调整好，字体、缩进频频出错，尤其是代码呈现部分，简直糟糕透顶！

此刻才明白，这个物件并非无关紧要的玩意儿，而是真正能提高工作效率的得力助手：

然而，"可乐和雪碧孰优孰劣"这个问题，其实不存在统一答案，关键在于个人口味，请结合自身情况来决定。

没有完美的工具，只有合适的工具！

优点 缺点

与富文本的对比：

对比维度

富文本（如 Word、 Docs）

编辑方式

使用纯文本 + 简单符号（如 # 表示标题）

使用按钮点击进行格式设置（如加粗、字体大小）

文件格式

.md 纯文本文件，轻量简洁

.docx、.xlsx 等，包含复杂格式信息

格式控制

通过符号定义结构和格式

所见即所得，直接调整字体、颜色、排版等

跨平台兼容性

极高，可在任意编辑器中打开

依赖特定软件，不同平台打开可能格式错乱

导出与转换

可轻松转换为 HTML、PDF、Word 等格式

支持导出多种格式，但格式依赖编辑器支持

图像与多媒体

支持插入图片，但无法调整大小、对齐等高级操作

支持插入图片、视频、表格、图表等，并可精细排版

协作与版本控制

与 Git 等版本控制系统天然兼容，易于多人协作

协作功能依赖特定平台（如 Docs），合并修改较复杂

学习成本

需要学习基础语法，适合喜欢高效写作的人

无需学习，直观易用，适合普通用户

适用场景

技术文档、博客、笔记、网页内容等

报告、简历、宣传材料、合同等需要精美排版的文档

第二部分: 工作原理

它属于一种文本标记方法，能够借助基础记号来调整文字形态，进而制作出HTML文档。

制作 .md 文件时，需要借助特定工具，例如插件、手机软件或网络编辑平台等来操作，通过这些工具可以将文件转化为 HTML 等其他类型，以便于查看或输出最终成果，第三部分内容为基本语法规则

别被"语法"这个词吓到，的语法比你想象的简单多了

（一）标题

标题是文章的支撑框架，能让读者迅速了解内容布局。在文档里，借助 # 号来设立不同级别的标题。

在行首插入 1 到 6 个 #，对应 1 到 6 级标题。

️ 警告：

一级标题必须具备独特性,一个文档里只能出现一个一级标题,这是构成规范文档的重要原则,行首位置必须放置#号,并且该符号不能与任何其他字符相邻,包括空格和制表符,标题文字与#号之间需要留有一个空格,标题的层级安排要符合逻辑顺序,不可以随意跨级使用

（二）段落和换行

一个段落包含若干连续的文本行，这些文本行构成一个整体，段落的前后要有两个以上的空行作为间隔

若要实现换行效果，可在行尾添加两个及以上空格后回车。

我是段落1，我后面有两个空格
我是段落2，我后面没有空格
我是段落3，我前面没有空格

渲染效果如下：

我是段落1intellij idea 2025，我后面有两个空格

我是段落2，我后面没有空格 我是段落3，我前面没有空格

（三）文本强调

文本优化有助于增强内容的可理解度和语言感染力。恰当的优化能够吸引阅读者的关注，凸显核心要点，提升作品的感染效果。系统内置了简便明了的格式指令，用以达成文本样式的调整，涵盖倾斜体、加粗体，以及这两种样式的搭配运用。

一个符号 * 或线 _ 代表斜体，两个符号 ** 或线 __ 代表加粗，三个符号 *** 或线 ___ 代表加粗且斜体

️ 建议：

统一使用 _ 表示斜体 统一使用 ** 表示加粗

*我是斜体文本*  
_我也是斜体文本_
**我是加粗文本**  
__我也是加粗文本__
***我是粗体+斜体文本***  
___我是粗体+斜体文本___  

渲染效果如下：

我是斜体文本

我也是斜体文本

我是加粗文本

我也是加粗文本

我是粗体+斜体文本

我是粗体+斜体文本

（四）列表

支持有序列表和无序列表。

无序列表

使用项目符号来列举事物intellij idea 2025，每个符号后面要加一个空格，然后写上具体的内容。

️ 注意：

建议统一使用 - ，视觉更清晰 标记符号后必须有一个空格

* 无序列表项1  
* 无序列表项2  
- 无序列表项3  
- 无序列表项4  
+ 无序列表项5  
+ 无序列表项6  

渲染效果如下:

有序列表

使用数字加 . 作为标记，后跟一个空格，再输入列表内容。

1. 有序列表项1
2. 有序列表项2
3. 有序列表项3

渲染效果如下:

有序列表项1有序列表项2有序列表项3嵌套列表

列表可以嵌套使用，创建多层次的结构

️ 警告：

子列表应当缩进两到四个空格，推荐使用两个空格，所有子列表必须保持一致的缩进长度，可以无限层嵌套，不过实际应用中不建议超过三层

无序列表嵌套：

- 水果
    - 苹果
        - 红苹果
        - 绿苹果
    - 橙子
        - 橘子
        - 橘橙
    - 香蕉
    - 梨
- 蔬菜
    - 胡萝卜
    - 白菜

渲染效果如下:

有序列表嵌套：

1. 需求阶段
    1. 收集需求
    2. 分析需求
2. 开发阶段
    1. 需求评审
    2. 需求开发
3. 上线阶段
    1. 测试
    2. 运维

渲染效果如下:

在需求环节 汇集用户要求,进行深入剖析,进入构建时期 开展评审工作,完成构建任务,随即进入发布环节 实施验证,最后进行维护管理

混合嵌套：

1. 主要任务
    - 子任务A
    - 子任务B
        1. 详细步骤1
        2. 详细步骤2
    - 子任务C
2. 次要任务

渲染效果如下:

核心职责 第一个子任务 第二个子任务 具体环节一 具体环节二 第三个子任务 副要职责五 网页地址链接

链接让 文档具有交互性，便于创建易于导航的内容。

语法格式：

[链接名称](链接地址)

[链接文字](链接地址 "可选的标题")

几个实际例子:

[百度](http://www.baidu.com)
访问那个知名的网络服务提供商，可以获取各类信息，只需在搜索框中输入所需内容并提交查询请求，马上就能得到相应的答复，它在全球范围内都享有很高的声誉
这个网站是一个关于编程的博客,网址是http://numerocode.top/,它分享了很多编程相关的知识。

邮箱和电话链接

请通过电子邮件与我建立联系，地址是example@email.com。
通过电话沟通：[致电](tel:+86-138-000-0000)

锚点链接

## 自定义锚点位置
[跳转到自定义位置](#custom-anchor)

[回到基础语法](#custom-anchor)  
[回到顶部](#)

（六）图片

图片能让文档更加生动和易于理解。

语法格式：

![替代文字](图片路径)
![替代文字](图片路径 "图片标题")

相对路径示例：

这张图片展示的是桌面上的一个截图,内容看起来像是一个文件列表,其中包括了各种文档和文件夹,背景是浅色的桌面,图片的边缘有一些轻微的变形。
用户界面展示在屏幕上，这是一个示例图片，用于说明界面布局，图片名称为用户界面演示。
图标位于images文件夹内，具体文件名为icon.svg，该图标代表应用，具有说明作用。

绝对路径示例：

这个图片文件位于本地路径下,具体路径为/Users/username/Documents/image.png,这是一个本地存储的位置,包含了图像数据,可以通过该路径访问到这个图片文件。
这个图片展示了系统的界面,内容清晰可见,细节十分丰富,可以用来分析具体情况,具有很高的参考价值。

直接引用网络图片：

这是我的个人标识，位于网站链接内，具体位置在图片展示部分，可以通过网络地址访问到，包含了头像的详细信息。
这个网址指向我的个人网站,它叫做数说编程,是一个分享编程知识和经验的平台,欢迎大家访问和交流。

目前尚无办法设定图像的尺寸大小，若确实需要调整，可借助常规的元素来实现。

（七）引用块

在引用内容行首添加 > 符号表示引用。

单个段落引用

> 这是一段引用内容。

渲染效果如下:

这是一段引用内容。

多个段落的块引用

> 我是段落1
>
> 我是段落2

渲染效果如下:

我是段落1

我是段落2

嵌套块引用

> 我是主段落
>
>> 1. 我是嵌套段落1
>> 2. 我是嵌套段落2

渲染效果如下:

我是主段落

我是嵌套段落1 我是嵌套段落2

（八）分割线

分割线用于分隔文档内容，创建清晰的层次结构。

常用于章节分隔和内容区块分隔。

水平分割线的三种写法： --- 或 *** 或 ___

️ 警告：

他必须立刻离开那个地方,否则将会面临严重的后果,而且他没有任何理由可以辩解,因为所有人都已经看穿了他的伎俩,他的欺骗行为再也藏不住了,接下来他将要付出代价,这是无法避免的事实,他最好做好最坏的打算,以免到时候措手不及,毕竟真相已经浮出水面,没有任何人能够再为他掩盖。

---
***
___

渲染效果如下：

（九）表格

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

:----: 使用冒号来设定文本的对齐形态，例如冒号左侧表示内容左移对齐，冒号右侧表示内容右移对齐，左右均有冒号则表示内容居中显示

️ 提示：

表格内部能够调整文字样式；例如：可以加粗，可以倾斜，能够插入行内代码 表格支持运用HTML标记

| 左对齐表头 | 居中对齐表头 |  右对齐表头 |
|:------ |:------:|-------:|
| 内容 | 内容 |      内容 |
| 内容 | 内容 |     内容 |

渲染效果如下:

使用Markdown标记,可以得到相应的显示样式,具体呈现方式因语法不同而有所区别。
用逗号分隔的多个小分句，表达相同意思，但词汇和结构完全不同，且不包含原文用词，专有名词保持不变。
|   `# 一级标题`    | 
 一级标题 
 |
|   `## 二级标题`   | 
 二级标题 
 |
|  `### 三级标题`   | 
 三级标题 
 |
|  `#### 四级标题`  | 
 四级标题 
 |
| `##### 五级标题`  | 
 五级标题 
 |
| `###### 六级标题` | 
 六级标题 
 |

渲染效果如下:

（十）代码块

支持的语言包括但不限于：

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

渲染效果如下:

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

（十一）内联元素

输出提示信息，采用日志记录方式，具体实现为调用.log函数，传递参数为"Hello World"，这种做法有助于后续问题排查，增强代码可维护性，同时方便团队协作。

键盘按键： 表示按键组合：Ctrl+C

删除线： 使用两个波浪号包围文本：已删除的内容

（十二）转义字符

当需要显示特殊字符本身时，请在字符前面添加反斜杠字符 \：

* 我是没有转义字符的段落.
\* 我是有转义字符的段落.

渲染效果如下：

* 我是有转义字符的段落.

常见的需要转义的字符包括：

精通语法规则，相当于获得了一种通用的书面交流工具，无论身处何处都能得体地阐述。

第四部分: 如何快速上手？

选择一个编辑器

循序渐进学习

动手实践

第五部分: 常见问题和解决方案常见问题解答：

为什么我的在不同平台显示不一致？

如何在中调整图片大小？

如何实现更复杂的表格？

第六部分: 数哥私藏资料推荐编辑器推荐：学习资源：结语

这个技巧，称得上关键本领吗，并非如此，但若说它无关紧要，确实能让你写作速度加快不少。学会这个方法，能令你的专业文章写作过程更加顺遂。

引用链接

: https://.net///

官方语法:

https://.net///

语法教程:

https://.com.cn/basic-/

菜鸟教程:

https://www..com//md-.html

如有侵权请联系删除！