积分14 / 贡献0

提问0答案被采纳0文章10

作者动态

[经验分享] MarkDown的语法详解

potato_princess 显示全部楼层 发表于 2024-12-28 18:39:16

一、标题

Markdown支持1~6级标题,使用 #号表示不同级别的标题,#号越多,标题级别越低。例如:

markdown复制代码# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题

二、段落

Markdown段落没有特殊的格式,直接编写文字即可。段落的换行是使用两个以上空格加回车,或者使用空行进行分隔。

三、字体

Markdown支持多种字体样式,包括斜体、粗体、删除线等。

  • 斜体:使用单个 *_将文字包裹起来即可实现斜体效果。例如:*斜体文本*_斜体文本_
  • 粗体:使用两个 **__将文字包裹起来即可实现粗体效果。例如:**粗体文本**__粗体文本__
  • 删除线:使用两个 ~~将文字包裹起来即可实现删除线效果。例如:~~删除线文本~~

此外,Markdown还支持下划线(通过HTML标签 <u>实现)、下标(使用两个 ~包裹文字)、上标(使用两个 ^包裹文字)等字体样式。

四、列表

Markdown支持有序列表和无序列表。

  • 无序列表:使用 *+-作为列表的标记,这些标记后面要加一个空格。例如:
markdown复制代码- 项目1- 项目2- 项目3
  • 有序列表:使用数字并加上 .表示。例如:
markdown复制代码1. 项目12. 项目23. 项目3

Markdown还支持列表嵌套和勾选列表。列表嵌套只需要在子列表中的选项前面添加四个空格(或使用Tab键)即可。勾选列表使用 [ ](未勾选)或 [x](已勾选)来表示。

五、区块

Markdown区块引用是在段落开头使用 >符号,后面紧跟一个空格符号。区块引用可以让文字显得更加突出,并且支持嵌套。例如:

markdown复制代码> 这是区块引用> > 这是嵌套区块引用

六、代码

Markdown支持代码高亮,如果是段落上的一个函数或片段的代码,可以用反引号(``)把它包裹起来。例如:print('hello world')`。

如果需要展示一段代码,可以使用三个反引号(`````)包裹代码,并指定一种语言(也可以不指定)。例如:

markdown复制代码```pythonimport requestsresp = requests.get(url='https://www.baidu.com')resp.encoding = 'utf-8'print(resp.text)```

七、链接和图片

  • 链接:Markdown链接的语法格式为 [链接文字](链接地址 "标题")。标题是可选项,鼠标经过链接文字时,会显示标题内容。Markdown还支持参考形式的链接,通过变量来设置一个链接,变量赋值在文档末尾进行。
  • 图片:Markdown图片的语法格式为 ![alt 属性文本](图片地址 "可选标题")。开头一个叹号(!),接着一个方括号,里面放上图片代替文字,接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 title属性的文字。

八、表格

Markdown制作表格使用 |来分隔不同单元格,使用 -来分隔表头和其他行。例如:

markdown复制代码| 表头1 | 表头2 ||-------|-------|| 单元格1 | 单元格2 |

Markdown还支持设置表格的对齐方式,通过在分隔符行中的短划线的左右两侧添加冒号(:)来实现。例如,左对齐使用 :--,右对齐使用 --:,居中对齐使用 :--:

九、分隔线

Markdown分隔线可以使用三个及以上的 *-_来表示,行内不能有其他东西。也可以在星号或是减号中间插入空格。例如:

markdown复制代码***---_____

十、高级技巧

  • 支持HTML元素:Markdown支持在文档中直接使用HTML标签,以扩展Markdown的功能。
  • 转义字符:Markdown使用 \转义特殊字符。
  • 数学公式:Markdown支持使用Tex或LaTeX格式的数学公式,使用两个 $包裹公式即可实现行内公式,使用 $$+回车包裹公式即可实现行间公式。

十一、其他

  • 待办事项列表:Markdown支持待办事项列表,使用 - [ ]表示未完成的待办事项,使用 - [x]表示已完成的待办事项。
  • 灰色底框:Markdown支持使用反引号(```)来标记单行文本,或使用三个反引号(`````)来标记多行文本,以实现灰色底框效果。

©著作权归作者所有,转载或内容合作请联系作者

您尚未登录,无法参与评论,登录后可以:
参与开源共建问题交流
认同或收藏高质量问答
获取积分成为开源共建先驱

Copyright   ©2023  OpenHarmony开发者论坛  京ICP备2020036654号-3 |技术支持 Discuz!

返回顶部