前言
- MarkDown是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档。本文使用样例进行描述。更详细的教程请参考MarkDown中文官网以及简书官方MarkDown教程。
- WEB端的MarkDown写作工具有简书、博客园、CSDN。Windows平台上的写作工具有MarkPad。
目录
- 区块元素
- 段落 换行 缩进
- 标题
- 区块引用
- 列表
- 代码区块
- 分割线
- 表格
- 区段元素
- 链接
- 强调
- 代码段
- 图片
区块元素
段落 换行 缩进
- 一个 Markdown 段落是由一个或多个连续的文本行组成。我的理解为,区块元素之间自动换行。区块/段元素之间多余的空格和换行会被自动忽略。下例两端之间有多个换行,而再MarkDown语法中被认为只存在一个换行。
区块/段元素之间多余的空格和换行会被自动忽略。
区块/段元素之间多余的空格和换行会被自动忽略。
区块/段元素之间多余的空格和换行会被自动忽略。
区块/段元素之间多余的空格和换行会被自动忽略。
- 如果你想要换行,可以嵌入HTML标签
<br>
进行换行。本文不建议使用换行,推荐一种代替是用列表元素-
或+
或*
包装每一个自然段。
我要换行<br>我要换行
我要换行
我要换行
- 关于缩进问题,Markdown的目的就是标记,而不是排版。所以并不推荐使用缩进。如果必要,可以插入全角空格或者
来缩进。
一个有缩进的开头
一个有缩进的开头
标题
Markdown使用前缀#
加一个空格来标记标题元素,一共可以分六级
# 一级标题
### 三级标题
###### 六级标题
一级标题
三级标题
六级标题
MarkDwon也支持使用=
或-
两种符号分别标记出一级标题和二级标题
一级标题
=
二级标题
-
一级标题
二级标题
区块引用
MarkDown使用>
符号标记区块引用。你可以用在每一行前面加标记,也可以在一整段的开头加标记。同时区块引用支持嵌套,且区块内部支持MarkDwon语法。
>在每一行前加标记
>在每一行前加标记
在每一行前加标记
在每一行前加标记
>在段首加标记在段首加标记在段首加标记在段首加标记在段首加标记在段首加标记在段首加标记
在段首加标记在段首加标记在段首加标记在段首加标记在段首加标记在段首加标记在段首加标记
>支持嵌套
>>我是嵌套
>
>支持嵌套
支持嵌套
我是嵌套
支持嵌套
>~~内部支持MarkDown语法~~
内部支持MarkDown语法
列表
Markdown 支持有序列表和无序列表。无序列表使用*
或+
或-
后加一个空格标记,并且支持嵌套,下例中用三种标记均可生效。
- 无序列表
- 无序列表
- 支持嵌套
- 无序列表
- 无序列表
- 支持嵌套
有序列表使用数字和英文句号进行标记
1. 有序列表
2. 有序列表
- 有序列表
- 有序列表
代码区块
代码区块使用```在上下标记
```
引用代码块
```
引用代码块
或者在代码前面插入四个半角空格标记代码块。
前面有四个半角空格
前面有四个半角空格
分割线
MarkDown使用三个以上的*
或-
的单独一行,标记分割线。
***
---
表格
表格也是以哦那个标记语言
标题|说明
-|-
表格元素|表格元素
标题 | 说明 |
---|---|
表格元素 | 表格元素 |
区段元素
链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。不管是哪一种,链接文字都是用 []
来标记。行内式使用()
标记链接地址,使用""
标记标题。
这是行内式链接指向[简书](https://www.jianshu.com "简书主页")
这是行内式链接指向简书
参考式将链接文字和链接地址分开,在连接文字后使用[]标记链接id,然后再文章任意位置说明id
这是参考式链接指向[简书][id_jianshu].
[id_jianshu]: https://www.jianshu.com/ "简书主页"
这是参考式链接指向简书.
强调
MarkDown支持斜体、加粗两种标记形式可以使用*
或_
在想要强调的内容的两侧进行标记。
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
single asterisks
single underscores
double asterisks
double underscores
代码段
在代码两端使用`包含代码即可
`这是代码段`
这是代码段
如果代码段中包含`符号,就在两侧使用2个`包含代码
``这是含有`的代码段``
这是含有`的代码段
图片
显然在纯文本的MarkDown中加入图片不是一件容易的事情。这里使用类似链接的插入方式进行插入图片。同时也支持参考式。
![pic](https://img.haomeiwen.com/i7604232/b40c83eab7a43fdb.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
网友评论