软件开发者和爱好者的知识分享社区
Markdown简易教程 关于本站 登录 注册
首页 > Markdown简易教程

Markdown是一种轻量级标记语言,语法简洁易学,适合快速编写文档。本站采用的就是Markdown编辑器,支持通用Markdown语法和GMF语法。

通用Markdown语法‌指原始的、标准化的Markdown规范,基于CommonMark等规范定义,强调简洁性和可移植性。

它支持基本内容结构,如标题、列表、链接、代码块和引用,但功能相对基础,例如标题使用井号(#)表示等级,列表通过破折号或数字创建,代码块需缩进或使用反引号。‌这种语法设计较为通用,可在大多数Markdown渲染器中运行,适合简单文档和跨平台内容共享。‌

GFM语法(GitHub Flavored Markdown)‌是Markdown在GitHub平台上的扩展版本,基于CommonMark但增加了实用特性。‌

本教程涵盖核心语法,帮助你快速上手。

标题与段落

标题的语法是通过在行首添加 # 号和一个空格创建,# 的数量对应标题级别(1-6级),越往后,字号越小。如:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

段落直接输入文本,段落间空一行以作分隔。‌

文本格式化

支持基本样式调整,包括:

加粗‌:用两个 * 或 _ 包围文本,如:**加粗文字**,效果:加粗文字

斜体:用一个 * 或 _ 包围文本,如:*斜体文字*,效果:斜体文字

删除线:用两个 ~ 包围文本,如:~~删除线~~,效果:删除线。‌

列表:‌

无序列表使用 -、+ 或 * 开头,后跟一个空格加具体内容。如:- 无序列表,效果:

  • 无序列表
  • 无序列表

有序列表用数字加点(如1.)开头,后跟一个空格加具体内容。如:1. 有序列表,效果:

  1. 第一章
    1. 第一节
    2. 第二节
  2. 第二章
    1. 第三节
    2. 第四节

任务列表用数字加点(如1.)开头,后跟一个空格加[ ],再跟着一个空格及具体内容。注意:中括号中间有一个空格,如:1. [ ] 任务一1. [x] 任务二,效果:

  1. 任务一
  2. 任务二

嵌套列表通过缩进(4个空格)实现;

引用块以 > 开头,后加空格和文本。‌如:

这是一段引用。

链接: 语法为 [显示文本](URL)。

图片: 语法为 ![描述](图片URL)。

代码块: 使用三个反引号包裹实现。如:
```js
var txt;
txt = 'hello!';
```

效果:

var txt;
txt = 'hello!';

行内代码: 用反引号包裹,如:`sudo apt install gimp`,效果:sudo apt install gimp

表格:‌ 表格由表头、分隔线和数据行组成,用管道符|分隔列,分隔线需至少3个连字符,换行可通过段落空行、行尾两个空格或<br>标签实现,特殊符号需转义(如\*显示星号)。‌
如:

标题1 标题2 标题3
内容1 内容2 内容3
内容4 内容5 内容6
友情链接: 海峰收银系统  
Copyright © 2025 HF软件技术. All Rights Reserved.
中华人民共和国工业和信息化部ICP备案序号:皖ICP备2025073039号