Markdown 语法词典
Markdown 对于大家俩说并不陌生了。Markdown 是一种轻量级的标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成结构化的 HTML。以下是 Markdown 的一些基本语法和示例,希望对大家有用。
标题
使用#
来表示标题。一个#
表示最大的标题(相当于 HTML 的<h1>
),六个#
表示最小的标题(相当于 HTML 的<h6>
)。
# 最大标题 ## 次级标题 ### 第三级标题 ... 以此类推 ###### 最小标题
强调
使用*
或_
来强调文本。
*这段文字会显示为斜体* _ 这段文字也会显示为斜体 _ **这段文字会显示为粗体** __ 这段文字也会显示为粗体** ~~这段文字会显示为删除线~~
列表
使用-
, +
, 或 *
创建无序列表。
- 列表项一 - 列表项二 - 子列表项一 - 子列表项二 + 第二个列表项 * 第三个列表项
有序列表使用数字后跟点来创建:
1. 第一项 2. 第二项 3. 第三项
链接
使用[]()
来创建链接。
[点击这里访问码云笔记](https://www.mybj123.com)
图片
使用![]()
来插入图片。
![替代文本](https://media.mybj123.com/wp-content/uploads/2020/04/1587112868-96d6f2e7e1f705a.png "可选的标题")
代码
使用反引号来标记代码。
`alert("Hello World!");`
对于代码块,使用三个反引号:
``` function example() { console.log("这是一个代码块示例"); } ```
引用
使用>
来创建引用。
> 这是一段引用文本 > 可以包含多行 > > 第二段引用文本
表格
使用|
和---
来创建表格。
| 标题 1 | 标题 2 | 标题 3 | |-------|-------|-------| | 单元格 1 | 单元格 2 | 单元格 3 | | 单元格 4 | 单元格 5 | 单元格 6 |
任务列表
使用- [ ]
和- [x]
来创建任务列表。
- [ ] 未完成的任务 - [x] 已完成的任务
转义字符
使用反斜杠\
来转义 Markdown 中的特殊字符。
\*这不是斜体\*
分隔线
使用三个或更多的*
, ---
或___
来创建分隔线。
--- 或者 *** ---
这些是 Markdown 的一些基本语法。使用这些语法可以创建格式丰富的文档,并且它们可以很容易地被转换成 HTML 格式。
除了以上基本语法,Markdown 的功能远不止于此。以下是一些更高级的 Markdown 特性和示例,掌握这些特性和用法,让你的文档一直编写一直爽。
内联 HTML
Markdown 支持内联 HTML,这意味着你可以在 Markdown 文档中直接使用 HTML 标签。
<div>这是一个 div 元素</div> <span>这是一个 span 元素</span>
块引用
块引用可以用于创建引用块,通常用于引用文本或代码。
> 这是一个引用块。 > > 你可以在引用块中使用 Markdown 语法,包括标题、列表等。
链接和图片的标题
链接和图片可以包含一个可选的标题作为工具提示。
[这是一个链接](https://www.mybj123.com "链接标题") ![这是一张图片](https://media.mybj123.com/wp-content/uploads/2020/04/1587112868-96d6f2e7e1f705a.png "图片标题")
脚注
一些 Markdown 解析器支持脚注,尽管这不是标准的 Markdown 语法。
这是一个脚注的例子[^1] [^1]: 这是脚注的内容。
折叠内容
一些 Markdown 编辑器支持折叠内容,允许你隐藏或展开部分文本。
<details> <summary>点击展开/折叠</summary> 这里是可以被折叠的内容... </details>
表格扩展语法
一些 Markdown 解析器支持更复杂的表格语法,包括对齐和分隔行。
| 左对齐 | 居中 | 右对齐 | | :------ | :---: | ------: | | 单元格 | 单元格 | 单元格 | | 单元格 | 单元格 | 单元格 |
定义列表
定义列表在标准的 Markdown 中不被支持,但在一些变体中可以使用。
项目 1 : 定义 1 项目 2 : 定义 2
流程图和序列图
一些 Markdown 解析器支持 Mermaid 语法,可以创建流程图和序列图。
graph LR A[开始] --> B{决策} B -- 是 --> C[结果 1] B -- 否 --> D[结果 2]
标记和删除线
在一些 Markdown 解析器中,你可以使用==
或~~
来标记文本或删除线文本。
这里是==标记的文本== 这里是~~删除线的文本~~
高亮
一些 Markdown 编辑器支持文本高亮。
==这段文本将被高亮==
行内属性(如字体大小和颜色)
一些 Markdown 解析器支持行内属性,如改变字体大小或颜色。
*小型*、**中型**、***大型*** ~~红色文本~~{: .red}
码云笔记提醒大家需要注意,并非所有的 Markdown 解析器都支持上述所有特性,特别是那些非标准的扩展特性。在使用时,你需要确认你的 Markdown 解析器或编辑器是否支持这些特性。
以上 Markdown 一些语法特性总结,个人觉对可以满足日常编写 Markdown(md)的需要了。