Markdown文本块语法及使用教程
编辑:本站更新:2025-02-14 07:48:07人气:5507
# Markdown 文本块语法与实践指南
## 一、基础篇:认识Markdown格式化语言
**Markdown**是一种轻量级的标记式语言,由约翰·格鲁伯(John Gruber)和亚伦·斯沃茨(Aaron Swartz)共同设计。其初衷是为了简化HTML内容编写过程,并让作者能够专注于文字本身而非排版样式,同时确保转换为结构化的 HTML 格式后依旧保持良好的可读性和美观性。
### **1. 段落**
在Markdown中,默认情况下连续的文字将被识别为一个段落,只需直接输入即可:
这是一个普通的段落。
换行即另起一段。
无需特殊符号或标签进行分隔。
转化后的效果如下:
> 这是一个普通的段落。
>
> 换行即另起一段。
>
> 无需特殊符号或标签进行分隔。
### **2. 标题**
通过井号 `#` 可以定义不同级别的标题。例如:
# 主要一级标题 (H1)
## 第二级标题(H2)
### 第三级标题(H3)
以此类推直到六级标题...
显示结果将是:
# 主要一级标题 (H1)
## 第二级标题(H2)
### 第三级标题(H3)
---
### **3. 强调文本**
- 斜体强调:用星号(`*`) 或下划线 (`_`) 包裹需要斜体的内容
*这是倾斜字体*
_这也是倾斜字体_
显示效果是:“*这是倾斜字体*” 和 “_这也是倾斜字体_”
- 粗体强调:使用两个星号(`**`) 或 下划线(`__`) 来包裹需要加粗的部分
**这是粗体**
__这同样也是粗体__
展示时会变成:“**这是粗体**” 和 “__这也同样是粗体__”
还可以组合这两种形式实现混合风格(先粗再斜):
***这种表示方式会使文本既变粗又变斜***
___同理,这种方式亦然___
最终展示:"***这种表示方式会使文本既变粗又变斜***" 和 "___同理,这种方式亦然___"
---
## 二、进阶功能运用
### **4. 列表项**
#### - 无序列表
只需要在一个新行开始处添加 `-`, `+`, 或者 `*` 符号并紧跟空格就能创建一条新的项目条目。
- 早餐菜单
- 面包
+ 牛奶
* 茶叶蛋
转化为实际视图:
- 早餐菜单
- 面包
+ 牛奶
* 茶叶蛋
#### - 有序列表
对于有序列表,在数字后面加上英文句点`.` 后跟一个空格来构建每一项:
1. 准备食材
2. 开始烹饪
3. 完成装盘
呈现的效果如同以下所示:
1. 准备食材
2. 开始烹饪
3. 完成装盘
### **5. 插入代码片段 & 缩进引用**
#### - 代码区块
为了插入单个或者多行代码片断,请围绕它们前后各放置三个反引号字符 (\`\`\`). 并可以指定编程语言以便正确高亮:
\
function helloWorld() {
console.log("Hello, World!");
}
\
展现如下的JavaScript代码段:
function helloWorld() {
console.log("Hello, World!");
}
#### - 表格嵌套/缩进引用
Markdown支持通过>` (大于号紧跟着波浪符) 创建引用区块。每个额外增加的大于号都会带来更深一层的嵌套级别:
>>> This is an indented quote.
>> And this one even more so!
视觉表现上则像这样:
>>> This is an indented quote.
>> And this one even more so!
---
## 三、高级应用举例
### **6. 分割线**
要在文档之间加入分割线,一行内仅需填写至少三个连在一起的破折号(---),或是等数量的星号(****)
---
or
*****
生成的结果分别是一道横杠以及一道满幅虚线作为间隔:
---
*****
### **7. 图片链接与超链接**
#### - 插入图片
采用感叹号 (!) 加方括号 ([]), 再接圆括号 () 的模式来引入图片资源地址及其描述文案:

用户看到的是具有“Alt text”替代文字段落的一张来自"https://example.com/image.jpg" 地址的图像。
#### - 添加超链接
利用 square brackets [] 对应 link title,紧接着使用 round parentheses () 放置 URL 即能完成外部连接设置:
[GitHub主页](http://www.github.com/)
点击阅读之后将会跳转至 GitHub 主页网址 http://www.github.com/
---
## 四、附加元素
### **8. 自动编号列表及其他扩展特性**
虽然基本标准的Markdown不包含自动编号的功能,但一些在线编辑器如Github Flavored Markdown(GFM),提供了对任务清单的支持:
- [ ] 待办事项A
- [x] 已完成功项B
上面的例子将在GFM环境下渲染出带勾选框的任务列表:
- [ ] 待办事项A
- [x] 已完成功项B
另外许多平台还针对表格、脚注甚至数学公式进行了增强拓展处理,使得Markdown能在更广泛的场景里发挥强大作用。
总结来说,熟练掌握Markdown的基本语法规则是非常有益且高效的写作技能,无论是撰写技术博客还是日常办公记录都能派得上大用场。而随着更多工具和服务对其特性的不断丰富和完善,未来Markdown的应用领域只会更加广阔多元。
## 一、基础篇:认识Markdown格式化语言
**Markdown**是一种轻量级的标记式语言,由约翰·格鲁伯(John Gruber)和亚伦·斯沃茨(Aaron Swartz)共同设计。其初衷是为了简化HTML内容编写过程,并让作者能够专注于文字本身而非排版样式,同时确保转换为结构化的 HTML 格式后依旧保持良好的可读性和美观性。
### **1. 段落**
在Markdown中,默认情况下连续的文字将被识别为一个段落,只需直接输入即可:
这是一个普通的段落。
换行即另起一段。
无需特殊符号或标签进行分隔。
转化后的效果如下:
> 这是一个普通的段落。
>
> 换行即另起一段。
>
> 无需特殊符号或标签进行分隔。
### **2. 标题**
通过井号 `#` 可以定义不同级别的标题。例如:
markdown
# 主要一级标题 (H1)
## 第二级标题(H2)
### 第三级标题(H3)
以此类推直到六级标题...
显示结果将是:
# 主要一级标题 (H1)
## 第二级标题(H2)
### 第三级标题(H3)
---
### **3. 强调文本**
- 斜体强调:用星号(`*`) 或下划线 (`_`) 包裹需要斜体的内容
markdown
*这是倾斜字体*
_这也是倾斜字体_
显示效果是:“*这是倾斜字体*” 和 “_这也是倾斜字体_”
- 粗体强调:使用两个星号(`**`) 或 下划线(`__`) 来包裹需要加粗的部分
markdown
**这是粗体**
__这同样也是粗体__
展示时会变成:“**这是粗体**” 和 “__这也同样是粗体__”
还可以组合这两种形式实现混合风格(先粗再斜):
markdown
***这种表示方式会使文本既变粗又变斜***
___同理,这种方式亦然___
最终展示:"***这种表示方式会使文本既变粗又变斜***" 和 "___同理,这种方式亦然___"
---
## 二、进阶功能运用
### **4. 列表项**
#### - 无序列表
只需要在一个新行开始处添加 `-`, `+`, 或者 `*` 符号并紧跟空格就能创建一条新的项目条目。
markdown
- 早餐菜单
- 面包
+ 牛奶
* 茶叶蛋
转化为实际视图:
- 早餐菜单
- 面包
+ 牛奶
* 茶叶蛋
#### - 有序列表
对于有序列表,在数字后面加上英文句点`.` 后跟一个空格来构建每一项:
markdown
1. 准备食材
2. 开始烹饪
3. 完成装盘
呈现的效果如同以下所示:
1. 准备食材
2. 开始烹饪
3. 完成装盘
### **5. 插入代码片段 & 缩进引用**
#### - 代码区块
为了插入单个或者多行代码片断,请围绕它们前后各放置三个反引号字符 (\`\`\`). 并可以指定编程语言以便正确高亮:
\
javascript
function helloWorld() {
console.log("Hello, World!");
}
\
展现如下的JavaScript代码段:
javascript
function helloWorld() {
console.log("Hello, World!");
}
#### - 表格嵌套/缩进引用
Markdown支持通过>` (大于号紧跟着波浪符) 创建引用区块。每个额外增加的大于号都会带来更深一层的嵌套级别:
markdown
>>> This is an indented quote.
>> And this one even more so!
视觉表现上则像这样:
>>> This is an indented quote.
>> And this one even more so!
---
## 三、高级应用举例
### **6. 分割线**
要在文档之间加入分割线,一行内仅需填写至少三个连在一起的破折号(---),或是等数量的星号(****)
markdown
---
or
*****
生成的结果分别是一道横杠以及一道满幅虚线作为间隔:
---
*****
### **7. 图片链接与超链接**
#### - 插入图片
采用感叹号 (!) 加方括号 ([]), 再接圆括号 () 的模式来引入图片资源地址及其描述文案:
markdown

用户看到的是具有“Alt text”替代文字段落的一张来自"https://example.com/image.jpg" 地址的图像。
#### - 添加超链接
利用 square brackets [] 对应 link title,紧接着使用 round parentheses () 放置 URL 即能完成外部连接设置:
markdown
[GitHub主页](http://www.github.com/)
点击阅读之后将会跳转至 GitHub 主页网址 http://www.github.com/
---
## 四、附加元素
### **8. 自动编号列表及其他扩展特性**
虽然基本标准的Markdown不包含自动编号的功能,但一些在线编辑器如Github Flavored Markdown(GFM),提供了对任务清单的支持:
markdown
- [ ] 待办事项A
- [x] 已完成功项B
上面的例子将在GFM环境下渲染出带勾选框的任务列表:
- [ ] 待办事项A
- [x] 已完成功项B
另外许多平台还针对表格、脚注甚至数学公式进行了增强拓展处理,使得Markdown能在更广泛的场景里发挥强大作用。
总结来说,熟练掌握Markdown的基本语法规则是非常有益且高效的写作技能,无论是撰写技术博客还是日常办公记录都能派得上大用场。而随着更多工具和服务对其特性的不断丰富和完善,未来Markdown的应用领域只会更加广阔多元。
www.php580.com PHP工作室 - 全面的PHP教程、实例、框架与实战资源
PHP学习网是专注于PHP技术学习的一站式在线平台,提供丰富全面的PHP教程、深入浅出的实例解析、主流PHP框架详解及实战应用,并涵盖PHP面试指南、最新资讯和活跃的PHP开发者社区。无论您是初学者还是进阶者,这里都有助于提升您的PHP编程技能。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。