Markdown语法笔记

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
Markdown 编写的文档后缀为 .md, .markdown。

Markdown 标题

使用 # 号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。

## 二级标题
### 三级标题

注:不同的 Markdown 应用程序处理 # 和标题之间的空格方式并不一致。为了兼容考虑,最好用一个空格在 # 和标题之间进行分隔。

Markdown 段落

换行

两句话之间用<br>隔开

第一行<br>第二行

换段

重新开始一个段落,就在段落后面使用一个空行来表示。

第一段

第二段

分隔线

在一行中用三个以上的星号*、减号-、底线_来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。

分隔内容1

----------
分隔内容2

-分隔内容时,分隔内容1下面需要空出一行,否则分隔内容1会变成二级标题,用*_则不会。

脚注

方括号[^ ]内添加插入符号和标识符。标识符可以是数字或单词,但不能包含空格或制表符。标识符仅将脚注参考与脚注本身相关联-在输出中,脚注按顺序编号。

要补充的文本 1 [^1] [^1p]
[^1]: 补充内容 1 第一段

    补充内容 1 第二段(双层缩进)
[^1p]: 补充内容 1p

要补充的文本2[^2]
[^2]: 补充内容 2

效果如下:

要补充的文本 1 [1] [2]

要补充的文本2[3]

页脚效果:

字体文本

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
~~删除线~~
<u>带下划线文本</u>
==标记文本==

效果如下:

斜体文本
粗体文本
粗斜体文本
删除线
带下划线文本
标记文本

空格

两句话之间加&nbsp;

这是一个带有空格&nbsp;&nbsp;的句子。

Markdown 列表

有序列表

有序列表使用数字并加上 . 号来表示(.后面没有空格不形成列表)

1. 第一项
2. 第二项
3. 第三项

.后有无空格区别如下:

1.没有空格
2.没有空格


  1. 有空格
  2. 有空格

无序列表

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格,然后再填写内容。此外,列表可以嵌套

* 第一项
  + 子项
    - 孙子项
      * 曾孙子
        * 以此类推
+ 第二项
  1. 子项
      * 孙子项
      * 孙子项
  2. 子项
      1. 孙子项
      2. 孙子项
- 第三项
  - 子项
  * 子项
    1. 孙子项

效果如下:

  • 第一项
    • 子项
      • 孙子项
        • 曾孙子
          • 以此类推
  • 第二项
    1. 子项
      • 孙子项
      • 孙子项
    2. 子项
      1. 孙子项
      2. 孙子项
  • 第三项
    • 子项
    • 子项
      1. 孙子项

Markdown 区块

Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号

> 这一行是区块
紧挨着上一行属于同一段落也是区块。

效果如下:

这一行是区块
紧挨着上一行属于同一段落也是区块。

区块嵌套

> 最外层
> > 第一层嵌套
> > > 第二层嵌套

效果如下:

最外层

第一层嵌套

第二层嵌套

列表包含引用

* 第一项
    > 引用一
    > 引用二
* 第二项

效果如下:

  • 第一项

    引用一
    引用二

  • 第二项

带有其它元素的块引用

> #### 带有其它元素的块引用
>
> - 无序列表
> 
> 1. 有序列表
> 2. 有序列表
> 
>  *斜体*和**粗体**

效果如下:

带有其它元素的块引用

  • 无序列表
  1. 有序列表
  2. 有序列表

斜体粗体

Markdown 代码

反引号

要将单词或短语表示为代码,请将其包裹在反引号(`)中。

`printf("hello,world");`

转义反引号

如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(``)中。

``Use `code` in your Markdown file.``

代码块

要创建代码块,请将代码块的每一行缩进至少四个空格或一个制表符(如果一个制表符缩进四个空格的话)。

    <html>
      <head>

      </head>
    </html>

围栏代码块

在代码块之前和之后的行上使用三个反引号(```)或三个波浪号(~~~)。

```
int main()
{
    printf("围栏代码块");
}  
```

Markdown 链接

基础用法

[超链接显示名](超链接地址)

这是[Markdown笔记](https://www.cnblogs.com/songpoetry/p/18363759)
这是Markdown笔记 <https://www.cnblogs.com/songpoetry/p/18363759>

效果如下:

这是Markdown笔记
这是Markdown笔记 https://www.cnblogs.com/songpoetry/p/18363759

给链接增加 Title

[超链接显示名](超链接地址 "超链接title")

这是[Markdown笔记](https://www.cnblogs.com/songpoetry/p/18363759 "BNSONG的博客")

链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。

效果如下:

这是Markdown笔记


  1. 补充内容 1 第一段

    补充内容 1 第二段(双层缩进) ↩︎

  2. 补充内容 1p ↩︎

  3. 补充内容 2 ↩︎

posted @ 2024-08-16 22:29  BN宋  阅读(33)  评论(0编辑  收藏  举报