企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
## **Markdown 基本语法教程** *本文所有资料来源于 [Markdown语法教程](https://markdown.com.cn/basic-syntax/ "前往访问"), 里面资料更全,这里只是做一个简单的整理与实践,方便快速入门,详细资料请去原链。* ### **1. 标题语法** 要创建标题,请在单词或短语前面添加井号 (#) 。# 的数量代表了标题的级别。 例如,添加三个 # 表示创建一个三级标题 ~~~ ### 我的头 ~~~ >### 我的头 --- ### **2. 段落语法** 要创建段落,请使用空白行将一行或多行文本进行分隔。 ~~~ 第一行 接下来空一行 第二行 ~~~ >第一行 接下来空一行 > >第二行 --- ### **3. 换行语法** 在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行(\<br>)。 ~~~ 这行后面有两个空格 然后回车 ~~~ >这行后面有两个空格,然后回车 > > >看到上面换行了 --- ### **4. 强调语法** * 粗体 要加粗文本,请在单词或短语的前后各添加两个星号(asterisks)或下划线(underscores)。 如需加粗一个单词或短语的中间部分用以表示强调的话,请在要加粗部分的两侧各添加两个星号(asterisks)。 ~~~ Never **made** it as a __wise__ man. ~~~ >Never **made** it as a __wise__ man. * 斜体 要用斜体显示文本,请在单词或短语前后添加一个星号(asterisk)或下划线(underscore)。 要斜体突出单词的中间部分,请在字母前后各添加一个星号,中间不要带空格。 ~~~ Never *made* it as a _wise_ man. ~~~ >Never *made* it as a _wise_ man. * 粗体和斜体 要同时用粗体和斜体突出显示文本,请在单词或短语的前后各添加三个星号或下划线。 --- ### **5. 引用语法** 要创建块引用,请在段落前添加一个 > 符号。 块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。 ~~~ >Never made it as a wise man >I couldn't cut it as a poor man stealing >>Tired of living like a blind man >>I'm sick of sight without a sense of feeling ~~~ >Never made it as a wise man >I couldn't cut it as a poor man stealing >>Tired of living like a blind man >>I'm sick of sight without a sense of feeling --- ### **6. 列表语法** * 有序列表 要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。 ~~~ 1. wise man 3. poor man 2. blind man 1. eye 1. heart 4. sick man ~~~ >1. wise man >3. poor man >2. blind man > 1. eye > 1. heart >4. sick man * 无序列表 要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。 缩进一个或多个列表项可创建嵌套列表。 ~~~ * wise man * poor man * blind man * eye * heart * sick man ~~~ >* wise man >* poor man >* blind man > * eye > * heart >* sick man --- ### **7. 代码语法** * 要将单词或短语表示为代码,请将其包裹在反引号 (`) 中。 ~~~ Never made it as a `wise man` ~~~ >Never made it as a `wise man` >>反引号在键盘左上,数字1键的左边,Esc键的下方。 * 代码块 要创建代码块,请将代码块的每一行缩进至少四个空格或一个制表符。 ~~~ import tensorflow as tf logo = 'gugu' ~~~ > import tensorflow as tf > logo = 'gugu' * 围栏代码块 在代码块之前和之后的行上使用三个反引号((```)或三个波浪号(~~~)。 ~~~ ```python import tensorflow as tf logo = 'gugu' ``` ~~~ 效果如下: >~~~python >import tensorflow as tf >logo = 'gugu' >~~~ --- ### **8. 分隔线语法** 要创建分隔线,请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容。 为了兼容性,请在分隔线的前后均添加空白行。 ``` wise man *** poor man --- blind man ___ ``` >wise man > >*** > >poor man > >--- > >blind man > >___ --- ### **9. 链接语法** * 通用链接 链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。 超链接Markdown语法代码:`[超链接显示名](超链接地址 "超链接title")` ``` 这是一个链接 [Py学习](https://www.kancloud.cn/chinabiue/asfe/2032564 "这是可选的title") ``` > 这是一个链接 [Py学习](https://www.kancloud.cn/chinabiue/asfe/2032564 "这是可选的title") * 网址和Email地址 使用尖括号可以很方便地把URL或者email地址变成可点击的链接。 ~~~ <https://www.kancloud.cn/chinabiue/asfe/2032564> <BET@bet.com> ~~~ ><https://www.kancloud.cn/chinabiue/asfe/2032564> ><BET@bet.com> --- ### **10. 图片语法** 要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。 插入图片Markdown语法代码:`![图片alt](图片链接 "图片title")`。 ~~~ ![这是图片](https://img.kancloud.cn/26/cc/26cccd3ba73772f27d8cd37132d5a2b5_1920x1080.jpg "Tucan") ~~~ >![这是图片](https://img.kancloud.cn/26/cc/26cccd3ba73772f27d8cd37132d5a2b5_1920x1080.jpg "Tucan") * 链接图片 给图片增加链接,请将图像的Markdown 括在方括号中,然后将链接添加在圆括号中。 ~~~ [![大嘴鸟](https://img.kancloud.cn/26/cc/26cccd3ba73772f27d8cd37132d5a2b5_1920x1080.jpg "Tucan")](https://www.kancloud.cn/chinabiue/asfe/2032564) ~~~ > [![大嘴鸟](https://img.kancloud.cn/26/cc/26cccd3ba73772f27d8cd37132d5a2b5_1920x1080.jpg "Tucan")](https://www.kancloud.cn/chinabiue/asfe/2032564) --- ### **11. 转义字符语法** 要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 () 。 ~~~ \* Without the backslash, this would be a bullet in an unordered list. ~~~ >\* Without the backslash, this would be a bullet in an unordered list.