您现在的位置是:首页 > 开发文档 > 正文

Markdown文本块语法及使用教程

编辑:本站更新:2024-09-16 08:50:10人气:5417
# 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)


用户看到的是具有“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编程技能。

转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。

最新推荐

本月推荐