devbox
小蓝xlanll
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

markdown 目录_Markdown语法说明

作者：小蓝xlanll | 2024-03-07 21:50:14

赞

踩

markdown目录语法

a4c10756e301b876bca78d5dc2163457.png

知乎对markdown支持有限，这里是github地址：

Study​shancumt.github.io

目录{#index}

[toc]

1. 强调

使用星号（*）和底线（_）作为标记强调字词的符号

  1. *斜体*或_斜体_  
  2. **粗体**或**粗体**  
  3. **加粗斜体**或**加粗斜体**  
  4. ~~删除线~~  
  5. 分隔线***（一行中三个或三个以上的星号*，减号-，和底线_建立一个分隔线，行内不能有其它东西，可以在星号或是减号中间插入空格）

2.标题

  1. # 一级标题（注意#后面的空格）  
  2. ## 二级标题  
  3. ### 三级标题  
  4. ……  
  5. ##### 五级标题  
  6. ###### 六级标题

3. 区块引用

3.1 类似 email 中用 > 的引用方式可以在每一行添加>或者偷懒只在第一行添加> 

  1. > 窗前明月光  
  2. > 疑是地上霜
窗前明月光
疑是地上霜

或者> 窗前明月光
疑似地上霜

窗前明月光
疑似地上霜

3.2 引用的嵌套

  1.  这是第一级引用
  2. >  
  3. >> 这是第二级引用  
  4. >
  5. > 现在又回到第一级引用
这是第一级引用
这是第二级引用
现在又回到第一级引用

3.3 引用区块内有其它元素

引用区块内可以使用其它Markdown语法，包括标题，列表，代码区块等

  1. > 这是一个标题 
  2. > 1. 这是第一行表（注意数字后面的**空格**）  
  3. > 2. 这是第二行表
这是一个标题 1. 这是第一行表（注意数字后面的 空格）
2. 这是第二行表

4.列表

4.1 无序列表

*、+、-（注意字符后面至少加一个空格或者制表符）
为了使列表看起来更漂亮，可以把内容用固定的缩进整理好，当然也可以不整理。

  1. - 床前明月光  
  2. - 疑是地上霜    
  3. - 举头望明月   
  4. 低头思故乡（和下文*低头思故乡*一样顶行写的，但是列表会对其自动进行整理）<br/>
  5.  
  6.     低头思故乡（前面加了一行空行，这是一个**新的段落**，可以对该段落缩进**1个制表符**，或者4个空格，来进行自动整理）
  7.  
  8. 低头思故乡（前面加了一行空行，这是一个**新的段落**）
  • 床前明月光
  • 疑是地上霜
  • 举头望明月
    低头思故乡（和下文低头思故乡一样顶行写的，但是列表会对其自动进行整理）
    低头思故乡（前面加了一行空行，这是一个新的段落，可以对该段落缩进1个制表符，或者4个空格，来进行自动整理）

低头思故乡（前面加了一行空行，这是一个新的段落）

4.2 有序列表

使用数字后面加一个英文句号.（允许有小于或等于3个空格的缩进）
1. 窗前明月光
疑似地上霜
3. 举头望明月
4. 低头思故乡

4.3 列表中放引用，那么>需要缩进

  1. - 静夜思  
  2.     > 窗前明月光   
  3.     > 疑似地上霜         
  4.     > 举头望明月           
  5.     > 低头思故乡
  • 静夜思 窗前明月光
    > 疑似地上霜
    > 举头望明月
    > 低头思故乡

4.4 列表中放代码区块，该区块需要缩进两次，也就是8个空格或2个制表符

  • 一列表项包含一个代码区块：
  • print(Hello,world!)

4.5 注意的使用

  1. What a great season.
    1986. What a great season. (在句点前面加上反斜杠，以避免出现数字-句点-空白 )

4.6 列表缩进

列表项目标记通常是放在最左边，但是其实也可以缩进，最多 3 个空格，项目标记后面则一定要接着至少一个空格或制表符。

4.7定义型列表

定义型列表由名词和解释组成。一行写上定义，紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab)

  1. Markdown  
  2. :    轻量级文本标记语言，可以转换成html，pdf等格式（左侧有一个可见的冒号和四个不可见的空格）
  3.  
  4. 代码块 2  
  5. :   这是代码块的定义（左侧有一个可见的冒号和四个不可见的空格）
  6.  
  7.         代码块（左侧有八个不可见的空格）

Markdown
: 轻量级文本标记语言，可以转换成html，pdf等格式（左侧有一个可见的冒号和四个不可见的空格）

代码块 2
: 这是代码块的定义（左侧有一个可见的冒号和四个不可见的空格）

代码块（左侧有八个不可见的空格）

4.8 任务列表

任务列表是标有[ ] 或者[x] (未完成或者完成)的列表
- [ ] 任务列表

6.代码

6.1 反引号包围的代码

`包围的代码`

6.2 代码区段插入反引号

在区段中间插入反引号：用多个反引号来开启和结束程式码区段 

``this is a literal backtick (`) here.``

this is a literal backtick (`) here. 在区段的开始插入反引号：程式码区段的起始和结束端都可以放入一个空白，起始端后面一个，结束端前面一个。

`` `foo` ``

`foo`

6.3 代码区段中插入HTML实体

& 和尖括号< >都会被转成 HTML 实体

  1. <div class="footer">
  2.     &copy; 2004 Foo Corporation
  3. </div>

© 2004 Foo Corporation

6.4 包围式代码块

  1. ```python
  2.         print(hello,world!)
  3. ​```python
  4. print(hello,world!)

或者进行缩进4个空格或者一个制表符 

print(hello,world!)

7.链接

7.1 行内式

格式：[链接文字](链接地址 '链接标题') ()中的""中可以为链接指定title属性，title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字，链接地址与链接标题前有一个空格。

百度主页

7.2 参考式

参考式超链接一般用在学术论文上面，或者另一种情况，如果某一个链接在文章中多处使用，那么使用引用 的方式创建链接将非常好，它可以让你对链接进行统一的管理。

格式：[链接文字][链接标记]
在文本的任意位置添加[链接标记]:链接地址 "链接标题"，链接地址与链接标题前有一个空格
如果链接文字本身可以做为链接标记，你也可以写成[链接文字][]
[链接文字]：链接地址的形式，见代码的最后一行。

我经常去的几个网站github、知乎以及简书， 简书是一个不错的写作社区。

8.自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用<>包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。

代码格式：<网址或链接>
address@example.com

9.锚点

网页中，锚点其实就是页内超链接，也就是链接本文档内部的某些元素，实现当前页面中的跳转。比如我这里写下一个锚点，点击回到目录，就能跳转到目录。 在目录中点击这一节，就能跳过来。还有下一节的注脚。这些根本上都是用锚点来实现的。

在你准备跳转到的指定标题后插入锚点{#标记}，然后在文档的其它地方写上连接到锚点的链接。

  1. 目录{#index}  
  2. 跳转到[目录](#index)

目录 {#index}
跳转到目录

10.图像

图片的创建方式与超链接相似，而且和超链接一样也有两种写法，行内式和参考式写法。
语法中图片Alt的意思是如果图片因为某些原因不能显示，就用定义的图片Alt文字来代替图片。 图片Title则和链接中的Title一样，表示鼠标悬停与图片上时出现的文字。 Alt 和 Title 都不是必须的，可以省略，但建议写上。

10.1 行内式

![图片Alt](图片地址 "图片Title")

10.2 参考式

在文档要插入图片的地方写![图片Alt][标记]
在文档的最后写上[标记]:图片地址 "Title"

11.目录

[TOC]

12.注脚

在需要添加注脚的文字后加上脚注[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注，脚注前必须有对应的脚注名字。
成功后会发现，即使你没有把注脚写在文末，经Markdown转换后，也会自动归类到文章的最后。

使用 Markdown^1可以效率的书写文档, 直接转换成 HTML^2, 你可以使用简书或者支持Markdown的编辑器进行书写。

13.数学公式

13.1 行内公式

$行内公式$

$E=mc^2$

13.2 行间公式

  1. $$
  2. 行间公式
  3. $$

14.表格

  1. 不管是哪种方式，第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行。

列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道

  1. 第二行还可以为不同的列指定对齐方向。默认为左对齐，在-右边加上:就右对齐，:--:居中对齐。
  1. | Left-Aligned  | Center Aligned  | Right Aligned |
  2. | :------------ |:---------------:| -----:|
  3. | col 3 is      | some wordy text | $1600 |
  4. | col 2 is      | centered        |   $12 |
  5. | zebra stripes | are neat        |    $1 |

| Left-Aligned | Center Aligned | Right Aligned | | :------------ |:---------------:| -----:| | col 3 is | some wordy text | $1600 | | col 2 is | centered | $12 | | zebra stripes | are neat | $1 |

15.段落

一个段落只是一个或者多个连续的文本行。
换行：段落的换行是使用两个或两个以上的空格加上回车;
段落：使用两个回车，中间形成一个空行来重新开始一个段落，markdown在渲染后，无论两个段落中间有多少个空行，最终只隔着一行

16.转义字符反斜线+字符

  1.    反斜线
  2. `   反引号
  3. *   星号
  4. _   底线
  5. {}  大括号
  6. []  方括号
  7. ()  括号
  8. #   井字号
  9. +   加号
  10. -   减号
  11. .   英文句点
  12. !   惊叹号

参考文献： Markdown语法手册
Markdo语法说明1
markdown语法说明2
markdown语法说明3

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/小蓝xlanll/article/detail/207655
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号