Ekkles' Diary

All human wisdom is summed up in two words: Wait and Hope

0%

Markdown

因为博客是使用Markdown编辑的,此文仅作查询备用之用途。

Markdown介绍

Markdown是一种轻量级标记语言,创始人为John Gruber。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。[4]这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。 由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,当前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。如_GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书_等,甚至还能被使用来撰写电子书。

格式

Markdown语法主要分为如下几大部分: 标题,段落,区块引用,代码区块,强调,列表,分割线,链接,图片,反斜杠 \,符号'`'。

标题

1)使用=-标记一级和二级标题。

1
2
3
4
一级标题
========
二级标题
--------

效果:

一级标题

二级标题

2)使用#,可表示1-6级标题(注意#和标题中间有空格)

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

段落

段落的前后要有空行,所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。

区块引用

在段落的每行或者只在第一行使用符号>,还可使用多个嵌套引用,如:

1
2
> 区块引用
>> 嵌套引用

效果:

区块引用

嵌套引用

代码区块

代码区块的建立是在每行加上4个空格或者一个制表符(如同写代码一样)。如 普通段落:

1
2
3
4
void main() %注意前面有4个空格
{
printf("Hello, Markdown.");
}

代码区块:

1
2
3
4
void main()
{
printf("Hello, Markdown.");
}

注意:需要和普通段落之间存在空行。

强调

在强调内容两侧分别加上*或者_,如

1
2
3
*斜体*,_斜体_
**粗体**,__粗体__
***斜粗体***,___斜粗体___

效果: 斜体斜体 粗体粗体 斜粗体斜粗体

列表

使用·+、或-标记无序列表,如:

1
-(+*) 第一项 -(+*) 第二项 - (+*)第三项

注意:标记后面最少有一个_空格_或_制表符_。若不在引用区块中,必须和前方段落之间存在空行。 效果:

  • 第一项
  • 第二项
  • 第三项

有序列表的标记方式是将上述的符号换成数字,并辅以.,如:

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

效果:

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

分割线

分割线最常使用就是三个或以上*,还可以使用-和_。

链接

使用 [描述](链接地址) 为文字增加外链接。 举例:

1
[Ekkles的博客](https://www.ekkles.com)

效果: Ekkles的博客

图片

添加图片的形式和链接相似,只需在链接的基础上前方加一个!。 例子:

1
![zybuluo](https://www.zybuluo.com/static//img/my_head.jpg)

效果: zybuluo

反斜杠\

相当于反转义作用。使符号成为普通符号。

删除线

使用 ~~ 表示删除线。 这是一段错误的文本。

表格

Markdown的表格比较麻烦,格式如下 要添加表,使用三个或多个连字符(---)创建每列的标题,并使用竖杠(|)分隔每列。您可以选择在表的任一端添加竖杠。

1
2
3
4
| Syntax      | Description |
| ----------- | ----------- |
| Header | Title |
| Paragraph | Text |

呈现的输出如下所示:

Syntax Description
Header Title
Paragraph Text

同时,还可以根据需求不同,有其他的格式设置,如对齐,可以对标题行的左侧、右侧或两侧同时添加冒号(:),分别对应于左对齐、右对齐、居中对齐。

由于Markdown的表格相对繁琐,这里更推荐使用网页工具一键转换。 比如https://markdown-convert.com/zh/tool/table

参考资料

Markdown-Wikipedia:https://zh.wikipedia.org/wiki/Markdown

Markdown 基本语法:https://github.com/younghz/Markdown