MarkDown常用语法及示例

本文介绍了MarkDown的基本语法,包括标题、引用、列表等,并详细解释了如何使用这些语法来增强文档的可读性和美观性。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

MarkDown常用语法及示例

1.标题

在文字开头加上“#”,通过“#”数量表示几级标题。(一共只有1~6级标题,1级标题字体最大),建议在井号后加一个空格,这是最标准的 Markdown 语法

>
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果:

一级标题

二级标题

三级标题

四级标题
五级标题
六级标题

2.引用

在段落的每行或者只在第一行使用符号>,还可使用多个嵌套引用,如:

>
> 区块引用
>> 嵌套引用

效果:

区块引用

嵌套引用

3.强调

斜体:将需要设置为斜体的文字两端使用1个“*”或者“_”夹起来
粗体:将需要设置为斜体的文字两端使用2个“*”或者“_”夹起来,如:

>
*斜体*
**粗体**
_斜体_
__粗体__

效果:

>
斜体
粗体
斜体
粗体

4.列表

4.1无序列表:在文字开头添加(, +, and -)实现无序列表,但是要注意在(, +, and -)和文字之间需要添加空格,如:

>
- 无序列表
* 无序列表
+ 无序列表

效果:

>
* 无序列表
+ 无序列表
- 无序列表

4.2有序列表:使用数字后面跟上句号.还要有空格,如:

>
1. 第一项
2. 第二项

效果:

>
1. 第一项
2. 第二项

5.分隔线

在一行连续使用三个或以上_或*,如:

>
___
***

效果:


6.代码区块

6.1行内代码:将使用`内容`来标记,不是单引号而是左上角的ESC下面的`,如:

>
`int main() {
reutrn 0;
}`

效果:

>
int main() {
reutrn 0;
}

6.2代码段落:每一行前边加入4个空格或者一个tab可以标记,如:

>
int main() {
reutrn 0;
}

效果:
int main() {
reutrn 0;
}

7.表格

>
Markdown中的表格书写建议使用TableEditor插件,该插件具有较好的自适应性,会自动对齐,强迫症患者喜欢。首先需要用ctrl + shift + p打开这个功能(Table Editor: Enable for current syntax or Table Editor: Enable for current view or “Table Editor: Set table syntax … for current view”),然后就可以狂用tab来自动完成了

第一行的标题需要手动录入,然后在第二行开始输入|-之后,直接按Tab键,然后在第三行输入test1后直接Tab键…
效果:
item1item2item3
test1test2test3dfdfdsfsd
test4test5test6

表格后面最好空一行

8.链接

Markdown有两种链接方式:Inline以及Reference
8.1文字链接

>
Inline:
[baidu](http://baidu.com/ “http://baidu.com/” )1
Reference:
[baidu][1]
[1]:http://baidu.com/http://baidu.com/“[^bbb]

效果:

>
Inline:
baidu
Reference:
baidu

8.2图像链接
添加图片的形式和链接相似,只需在链接的基础上前方加一个!

>
Inline:
![test1](http://i1.tietuku.com/a632dc100fbf5a4b.png “Markdown”)2
Reference:
![test1][1]
[1]:http://i1.tietuku.com/a632dc100fbf5a4b.png “Markdown”[^bbb]

效果:

Inline:
test1
Reference:
test1

8.3自动链接

使用尖括号<>包含住一段地址或者邮箱
\http://www.baidu.com\
\loulvlin@travelsky.com\

效果:

>
http://www.baidu.com
loulvlin@travelsky.com

9.转义字符

Markdown中的转义字符为\,可以转义的有:
\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号

10.脚注

实现方式如下:

>
footnotetest[^Footnote]
>
[^Footnote]:Footnote_Text

效果:

footnotetest[^Footnote]

11.目录

需要安装MarkdownPreview插件,在最前面添加[TOC]可以自动生成目录

NOTICE:这种方式生成的目录在文档最上面,实用性不是很方便,如要在文档左侧生成目录,需要借助其它方法来实现,请参考Markdown左侧目录

12.段落与缩进

markdown中各段落之间需要一个空行进行分隔

半方大的空白&ensp;&#8194;,放在段首即可实现缩进
全方大的空白&emsp;&#8195;,放在段首即可实现缩进
不断行的空白格&nbsp;&#160;,放在段首即可实现缩进

例子:

放在段首即可实现缩进

&emsp;&emsp;放在段首即可实现缩进

放在段首即可实现缩进

效果:

放在段首即可实现缩进

  放在段首即可实现缩进

放在段首即可实现缩进


  1. ()括号中的第二部分(“”包着的内容)可以省略,功能是一样的
    [^bbb]:连接后面第二部分(“”包着的内容)可以省略,功能是一样的
    [^Footnote]:Footnote_Text
  2. ()括号中的第二部分(“”包着的内容)可以省略,功能是一样的
    [^bbb]:连接后面第二部分(“”包着的内容)可以省略,功能是一样的
    [^Footnote]:Footnote_Text
<think>首先,用户的问题是:“我想学习Markdown常用语 请问Markdown 常用语指南”。这翻译成“I want to learn the common syntax of Markdown. Please provide a guide to common Markdown syntax.” 根据系统级指令: - 所有行内数学表达式必须使用$...$格式。用户的问题中没有数学表达式,所以可能不需要。 - 独立公式必须使用$$...$$格式并单独成段。同样,用户的问题不涉及数学公式。 - LaTeX语法正确:确保任何数学部分正确,但这里可能不适用。 - 使用中文回答:整个回答必须用中文。 - 生成相关问题:在回答末尾,需要生成相关问题。 - 回答中引用的段落末尾自然地添加引用标识:例如[^1]。参考站内引用提供了[^1]和[^2],但指令说“上述引用仅供参考”,所以我应该基于用户的问题来引用,如果有必要。用户的问题是学习Markdown语法,所以我需要提供指南。 参考站内引用: - 引用[1]: 提到Markdown语法的重要性,快捷键等。 - 引用[2]: 详细列出了Markdown语法,包括标题、字体、线条、列表等。 我应该使用这些作为参考来构建我的回答,但确保回答真实可靠。 回答结构: - 清晰、逐步帮助用户解决问题。 - 既然用户要学习常用语,我应该提供一个结构化的指南。 大纲回答: 1. 介绍Markdown是什么。 2. 列出常用语元素: - 标题 - 字体样式(粗体、斜体等) - 列表(有序和无序) - 链接和图片 - 代码块 - 引用区块 - 表格 - 数学公式(如果需要) - 其他(如分割线、脚注等) 3. 提供简单示例。 4. 确保使用中文。 5. 在末尾生成相关问题。 生成相关问题: - 指令说:“生成相关问题”,并参考示例,如快速排序的例子。 - 相关问题应该基于主题,如“Markdown语法的应用场景?”或“如何优化Markdown写作?” 引用标识: - 如果在回答中引用特定段落,添加[^1]等。但在这个主题中,可能不需要直接引用,除非我引用参考材料。指令说“回答中引用的段落末尾自然地添加引用标识”,所以我应该只在引用时使用。 参考站内引用是[^1]和[^2],所以我可以在回答中提到它们。 最终回答结构: - 开头介绍Markdown。 - 分部分解释语法。 - 提供代码示例(如代码块)。 - 结束时生成相关问题。</think>### Markdown 常用语指南 Markdown 是一种轻量级标记语言,用于格式化纯文本文档,使其易于转换为 HTML 或其他格式。它广泛应用于博客、文档编写(如 GitHub、Stack Overflow)和笔记工具中。以下是一个结构化的常用语指南,基于核心元素逐步讲解,并附有简单示例。每个语法点都以中文解释,并确保代码示例正确。 #### 1. **标题** 标题用于创建文档结构,通过在行首添加井号(`#`)表示不同级别。一级标题最大,六级标题最小。 - 示例: ```markdown # 一级标题 ## 二级标题 ### 三级标题 ``` 输出效果: # 一级标题 ## 二级标题 ### 三级标题 #### 2. **字体样式** Markdown 支持基本的文本样式,包括粗体、斜体和删除线。 - **粗体**:用两个星号或下划线包围文本,例如 `**粗体**` 或 `__粗体__`。 - **斜体**:用一个星号或下划线包围文本,例如 `*斜体*` 或 `_斜体_`。 - **粗斜体**:结合使用,例如 `***粗斜体***`。 - **删除线**:用两个波浪线包围文本,例如 `~~删除线~~`。 - 示例: ```markdown 这是 **粗体** 文本,这是 *斜体* 文本,这是 ***粗斜体*** 文本,这是 ~~删除线~~ 文本。 ``` 输出效果: 这是 **粗体** 文本,这是 *斜体* 文本,这是 ***粗斜体*** 文本,这是 ~~删除线~~ 文本。 #### 3. **列表** 列表分为无序列表和有序列表,支持嵌套。 - **无序列表**:使用星号、加号或减号开头,例如 `* 项目1`。 - **有序列表**:使用数字加句点开头,例如 `1. 项目1`。 - **嵌套列表**:通过缩进(通常两个空格)创建子列表。 - 示例: ```markdown - 无序项目1 - 子项目1 - 子项目2 1. 有序项目1 1. 子项目1 2. 子项目2 ``` 输出效果: - 无序项目1 - 子项目1 - 子项目2 1. 有序项目1 1. 子项目1 2. 子项目2 #### 4. **引用区块** 用于引用文本,以 `>` 开头。 - 示例: ```markdown > 这是一个引用区块。 > 可以多行书写。 ``` 输出效果: > 这是一个引用区块。 > 可以多行书写。 #### 5. **代码块** 展示代码片段,支持行内代码和独立代码块。 - **行内代码**:用反引号包围,例如 `` `代码` ``。 - **独立代码块**:用三个反引号包围,并指定语言(可选)。 - 示例: ```markdown 行内代码示例:`print("Hello, Markdown!")`。 独立代码块(Python): ```python def hello(): print("Hello, Markdown!") ``` ``` 输出效果: 行内代码示例:`print("Hello, Markdown!")`。 独立代码块(Python): ```python def hello(): print("Hello, Markdown!") ``` #### 6. **链接和图片** 插入超链接和图像。 - **链接**:使用 `[文本](URL)` 格式,例如 `[Google](https://www.google.com)`。 - **图片**:使用 `![替代文本](图片URL)` 格式,例如 `![Logo](logo.png)`。 - 示例: ```markdown 访问 [Google](https://www.google.com) 或插入图片:![Markdown Logo](https://example.com/logo.png) ``` 输出效果:访问 [Google](https://www.google.com) 或插入图片(假设 URL 有效)。 #### 7. **表格** 创建简单表格,使用竖线和连字符。 - 语法:列之间用 `|` 分隔,表头与内容用 `---` 分隔。 - 示例: ```markdown | 姓名 | 年龄 | 城市 | |--------|------|----------| | 张三 | 25 | 北京 | | 李四 | 30 | 上海 | ``` 输出效果: | 姓名 | 年龄 | 城市 | |--------|------|----------| | 张三 | 25 | 北京 | | 李四 | 30 | 上海 | #### 8. **分割线和脚注** - **分割线**:用三个连字符、星号或下划线创建,例如 `---`。 - **脚注**:用 `[^标识]` 和 `[^标识]: 说明` 定义。 - 示例: ```markdown 这是一段文本。[^1] --- [^1]: 这是脚注说明。 ``` 输出效果: 这是一段文本。[^1] --- [^1]: 这是脚注说明。 #### 9. **数学公式(可选)** Markdown 支持 LaTeX 语法嵌入数学公式,常用在技术文档中。 - **行内公式**:用 `$...$` 格式,例如 `$E = mc^2$`。 - **独立公式**:用 `$$...$$` 格式并单独成段。 - 示例: ```markdown 质能方程:$E = mc^2$。 独立公式: $$ \sum_{i=1}^{n} i = \frac{n(n+1)}{2} $$ ``` 输出效果: 质能方程:$E = mc^2$。 独立公式: $$ \sum_{i=1}^{n} i = \frac{n(n+1)}{2} $$ #### 总结 Markdown 语法简单易学,能快速提升文档可读性。常用工具包括 Typora、VS Code 等编辑器。掌握这些基础后,您可以轻松编写博客、GitHub README 或技术文档。更多细节可参考 Markdown 官方文档或社区资源[^1][^2]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值