markdown语法手册
markdown
2024-03-04 2405字

Markdown详细教程+技巧总结_markdown课程-CSDN博客

1. 斜体和粗体

代码:

*斜体*或_斜体_
**粗体**
***加粗斜体***
~~删除线~~

显示效果:

2. 分级标题

第一种写法:

这是一个一级标题
============================
这是一个二级标题
--------------------------------------------------

第二种写法:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

由于用了[TOC]标记编辑器会把所有标题写到目录大纲中,在这里写的演示标题也会列进去,所以就不演示了。同学们自己在编辑器中观察,很简单,一级标题字号最大,依级递减。

3. 超链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式,行内式一般使用较多。

3.1. 行内式

语法说明:

代码:

欢迎来到[梵居闹市](http://blog.leanote.com/freewalk)
欢迎来到[梵居闹市](http://blog.leanote.com/freewalk "梵居闹市")

显示效果:

欢迎来到梵居闹市

欢迎来到梵居闹市

4. 锚点

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

注意:

  1. Markdown Extra 只支持在标题后插入锚点,其它地方无效。
  2. Leanote 编辑器右侧显示效果区域暂时不支持锚点跳转,所以点来点去发现没有跳转不必惊慌,但是你发布成笔记或博文后是支持跳转的。

语法描述:

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

代码:

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

5. 列表

5.1. 无序列表

使用 *,+,- 表示无序列表。

代码:

- 无序列表项 一
- 无序列表项 二
- 无序列表项 三

显示效果:

5.2. 有序列表

有序列表则使用数字接着一个英文句点。

代码:

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三

显示效果:

  1. 有序列表项 一
  2. 有序列表项 二
  3. 有序列表项 三

6. 引用

语法说明:

引用需要在被引用的文本前加上>符号。

代码:

> 这是一个有两段文字的引用,
> 无意义的占行文字1.
> 无意义的占行文字2.
> 
> 无意义的占行文字3.
> 无意义的占行文字4.

显示效果:

这是一个有两段文字的引用, 无意义的占行文字1. 无意义的占行文字2.

无意义的占行文字3. 无意义的占行文字4.

Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :

代码:

> 这是一个有两段文字的引用,
无意义的占行文字1.
无意义的占行文字2.
> 无意义的占行文字3.
无意义的占行文字4.

显示效果:

这是一个有两段文字的引用, 无意义的占行文字1. 无意义的占行文字2. 无意义的占行文字3. 无意义的占行文字4.

7. 插入图像

图片的创建方式与超链接相似,而且和超链接一样也有两种写法,行内式和参考式写法。

语法中图片Alt的意思是如果图片因为某些原因不能显示,就用定义的图片Alt文字来代替图片。 图片Title则和链接中的Title一样,表示鼠标悬停与图片上时出现的文字。 Alt 和 Title 都不是必须的,可以省略,但建议写上。

7.1. 行内式

语法说明:图片Alt

代码:

1. 美丽花儿: 
2. ![美丽花儿](http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg "美丽花儿")

显示效果:

美丽花儿:

7.2. 参考式

语法说明:

在文档要插入图片的地方写![图片Alt][标记]

在文档的最后写上[标记]:图片地址 “Title”

代码:

1. 美丽花儿:
2. ![美丽花儿][flower]
3. 
4. [flower]:http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg  "美丽花儿"

显示效果:

美丽花儿:

8. 代码

对于程序员来说这个功能是必不可少的,插入程序代码的方式有两种,一种是利用缩进(Tab), 另一种是利用`符号(一般在ESC键下方)包裹代码。

语法说明:

插入行内代码,即插入一个单词或者一句代码的情况,使用code这样的形式插入。

插入多行代码,可以使用缩进或者```,具体看示例。

注意: 缩进式插入前方必须有空行

8.1. 行内式

代码:

C语言里的函数 `scanf()` 怎么使用?

显示效果:

C语言里的函数 scanf() 怎么使用?

8.2. 缩进式多行代码

缩进 4 个空格或是 1 个制表符

一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。

代码:

    #include <stdio.h>
    int main(void)
    {
        printf("Hello world\n");
    }

显示效果:

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

8.3. 用六个`包裹多行代码 代码:

\```
#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
\```

显示效果:

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}