markdown基本语法
文章目录Markdown 基础语法速查一、标题二、段落与换行三、字体样式四、引用五、列表六、代码块七、链接1. 行内式最常用2. 参考式3. 自动链接八、图片九、分割线十、表格十一、转义字符十二、常用拓展语法部分编辑器支持Markdown 基础语法速查Markdown 是一种轻量级标记语言通过简单的符号标记实现文本排版语法简洁易记无需复杂操作即可生成规整的格式广泛用于文档、笔记、博客等场景纯文本编写跨平台兼容。一、标题用 # 表示# 数量对应标题级别1-6 级# 与标题文字之间需加一个空格级别越高字体越大。# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题建议文档中一级标题仅用 1 个作为总标题二级标题作为大板块依次层级递进保证结构清晰。二、段落与换行段落直接输入文字两个回车表示新段落会自动留空行强制换行一行文字末尾加两个空格再回车实现同段落内换行无空行。这是第一个段落直接编写即可。 两个回车 这是第二个段落与上一段有空白行。 这是同一段落的第一行。两个空格回车 这是同一段落的第二行无空白行衔接。三、字体样式常用四种基础样式符号与文字之间无空格可组合使用如下划线 粗体。**粗体**文字前后加2个*或2个_ *斜体*文字前后加1个*或1个_ ***粗斜体***文字前后加3个*或3个_ ~~删除线~~文字前后加2个~ u下划线/u用HTML标签u/uMarkdown原生无下划线语法四、引用用 表示支持多层嵌套多个 引用内可嵌套其他语法如字体、列表。 一级引用 二级引用 三级引用 **引用内的粗体** *引用内的斜体*效果一级引用二级引用三级引用引用内的粗体引用内的斜体五、列表分无序列表、有序列表支持嵌套列表内嵌套列表、引用、代码块等嵌套时需缩进 4 个空格或 1 个 Tab。1. 无序列表用 *、、- 表示符号与文字之间加一个空格三种符号效果一致可混用。* 无序列表项1 无序列表项2 - 无序列表项3 - 嵌套无序列表项缩进4个空格 * 二级嵌套效果无序列表项1无序列表项2无序列表项3嵌套无序列表项缩进4个空格二级嵌套2. 有序列表用「数字 .」表示数字可任意渲染后会自动按顺序排列. 与文字之间加一个空格。1. 有序列表项1 2. 有序列表项2 3. 有序列表项3 1. 嵌套有序列表项缩进4个空格 2. 二级嵌套效果有序列表项1有序列表项2有序列表项3嵌套有序列表项缩进4个空格二级嵌套六、代码块分行内代码和块级代码用于展示代码、命令、关键符号避免被 Markdown 解析。行内代码用 反引号键盘 Tab 键上方包裹嵌入段落中。行内代码示例print(Hello Markdown)Python中用#表示注释。效果行内代码示例print(Hello Markdown)Python 中用#表示注释。块级代码用三个反引号 包裹单独成块可指定语言如python、java、html实现语法高亮上下的需单独占行。python # Python代码示例 def hello(): print(Hello Markdown!) hello()效果# Python代码示例defhello():print(Hello Markdown!)hello()七、链接分行内式链接、参考式链接、自动链接适用于跳转网页、文档、图片等。1. 行内式最常用格式[链接文字](链接地址 链接标题)链接标题可选鼠标悬停在链接上时显示。[百度](https://www.baidu.com 全球最大搜索引擎) [我的笔记](./note.md 本地笔记文档)效果百度2. 参考式先定义链接标识再在需要的地方引用适合同一链接多次使用的场景标识可自定义数字、字母、文字。// 定义链接可放在文档任意位置一般在末尾 [1]: https://www.github.com GitHub官网 [2]: ./image.jpg 本地图片 // 引用链接 GitHub官网[点击访问][1] 本地图片[查看][2]效果GitHub官网点击访问本地图片查看3. 自动链接直接用 包裹网址 / 邮箱会自动渲染为可点击的链接。https://www.csdn.net 123456qq.com效果https://www.csdn.net 、123456qq.com八、图片与链接语法相似仅在前面加一个格式[图片替代文字]图片地址 “图片标题”图片替代文字图片加载失败时显示的文字必填图片地址可填网络图片 URL或本地图片路径相对路径 / 绝对路径图片标题可选鼠标悬停显示。// 网络图片// 本地图片相对路径图片与md文档同目录// 本地图片绝对路径Windows示例效果// 网络图片// 本地图片相对路径图片与md文档同目录// 本地图片绝对路径Windows示例注意Markdown 本身不支持调整图片大小如需调整可使用 HTML 的标签。九、分割线用 ***、—、___ 表示单独占行前后无其他文字符号数量至少 3 个可连续写如----效果一致。这是分割线上方的内容这是分割线下方的内容另一条分割线十、表格Markdown 表格为简易表格支持左对齐、右对齐、居中对齐第一行为表头第二行为对齐方式分隔线第三行开始为内容| 分隔列- 表示分隔线列之间的空格不影响渲染。格式| 表头1 | 表头2 | 表头3 | | :---- | :---: | ----: | | 内容1 | 内容2 | 内容3 | | 内容4 | 内容5 | 内容6 |效果表头1表头2表头3内容1内容2内容3内容4内容5内容6:----左对齐默认:—:居中对齐----:右对齐注意第二行的-数量至少 1 个与表头列数一致。十一、转义字符当需要显示 Markdown 语法符号如#、*、|本身而非其语法效果时在符号前加 ** 反斜杠 ** 进行转义。\# 这不是一级标题 \* 这不是斜体 \| 这是竖线本身效果# 这不是一级标题* 这不是斜体| 这是竖线本身十二、常用拓展语法部分编辑器支持以上为 Markdown原生基础语法不同编辑器如 Typora、VS Code、语雀会支持拓展语法常用的有任务列表用 - [ ]未完成、- [x]已完成表示中括号内的空格 /× 为关键与文字之间加空格。- [ ] 学习Markdown基础语法 - [x] 掌握标题和字体样式 - [ ] 练习表格和代码块效果学习Markdown基础语法掌握标题和字体样式练习表格和代码块