Hexo中的Markdown语法总结

橙子随记
660 阅读7分钟

本文已参与「新人创作礼」活动，一起开启掘金创作之路。

语法.png

Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯，它允许人们使用易读易写的纯文本格式编写文档。由于Markdown的轻量化、易读易写特性，并且对于图片，图表、数学式都有支持，目前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等 ——维基百科

1 标题

1.1 效果

标题效果显示出来会影响目录结构，就不显示效果了。一个 # 号标记一级标题，总共有六级标题，# 号个数依次增加，# 号和后面跟的标题内容要用空格隔开。

1.2 语法格式

# h1         //一级标题 对应 <h1> </h1>
## h2        //二级标题 对应 <h2> </h2>
### h3       //三级标题 对应 <h3> </h3>
#### h4      //四级标题 对应 <h4> </h4>
##### h5     //五级标题 对应 <h5> </h5>
###### h6    //六级标题 对应 <h6> </h6>

2 字体

2.1 效果

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本
删除线
下划线
下划线+删除线+粗斜体

本文斜体和粗体被渲染成了 #FF7E00色，所以上面效果会有颜色区分。斜体、粗体、带下划线、带删除线等字体效果可以组合使用，见上面的下划线+删除线+粗斜体

2.2 语法格式

*斜体文本*
_斜体文本_  
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
~~删除线~~
<u>下划线</u>
<u>~~***下划线+删除线+粗斜体***~~</u>

3 段落

3.1 效果

不要用空格（spaces）或制表符（ tabs）缩进段落，会没有效果。I really like using Markdown.我真的喜欢使用Markdown。I think I'll use it to format all of my documents from now on.我想从现在开始我会用它来格式化我的所有文档。

  带首行缩进段落，不要用空格（spaces）或制表符（ tabs）缩进段落，会没有效果。I really like using Markdown.我真的喜欢使用Markdown。I think I'll use it to format all of my documents from now on.我想从现在开始我会用它来格式化我的所有文档。

3.2 语法格式

半角空格:&ensp; 
全角空格:&emsp;  \\&emsp;&emsp;实现首行缩进两个字符的效果
换行标签:<br>

4 分割线

4.1 效果

在文档中，分割线起划分文章结构及美观的作用，在Markdown中其可以用连续3个及以上的星号*、减号-、下划线_来表述。

4.2 语法格式

***
---
___

5 列表

5.1 效果

  1. 第一项
  2. 第二项
  3. 第三项
  • 第一项
  • 第二项
  • 第三项
  1. 第一项：
    • 子列表1
    • 子列表2
  2. 第二项：
    • 子列表1
    • 子列表2

上面分别是有序列表、无序列表、嵌套列表效果。

5.2 语法格式

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

- 第一项
- 第二项
- 第三项

1. 第一项：
    - 子列表1
    - 子列表2
2. 第二项：
    - 子列表1
    - 子列表2

6 代码块

6.1 效果

#include <stdio.h>

int main(void)
{
    printf("Hello, world!\n");
    return 0;
}

Markdown它能够轻松漂亮地插入代码。方法是，使用三个反引号``` 进行包裹即可。如果是行内代码引用，使用单个反引号`或者<code></code>进行包裹，行内效果，如下：

markdown, c, c++, learning by doing。

6.2 语法格式

```c
pubic static void main(String[] args) {
  System.out.println("Hello world");
}
```

7 插入表格

7.1 效果

第一列第二列第三节
我要左对齐我要居中我要右对齐
align leftcenteralign right

7.2 语法格式

以下是插入表格的语法格式，左对齐、居中对齐、右对齐分别用:------、:------:、-------:来控制。

| 第一列 | 第二列 |第三节 |
|:--------| :---------:|--------:|
| 我要左对齐 | 我要居中 |我要右对齐|
| align left | center |align right|

8 图片

8.1 效果

橙子
动物园

8.2 语法格式

格式1是markdown中提供的固有语法，无法设置图片大小和位置，格式2和格式3用了html中的img和div标签，能够完成图片大小和位置设置。 格式1

![图片描述](图片url)

格式2：可以设置图片大小，调整width值

<img width="300" alt="图片描述" src="图片url"/>

格式3：可以设置图片大小和位置，调整width、align来完成

<div align="right"><img width="500" alt="图片描述" src="图片url"/></div>

9 引用

9.1 效果

他现在认识到，他是一个普普通通的人，应该按照普通人的条件正正常常的生活，而不要做太多的非分之想。当然，普通并不等于庸俗。他也许一辈子都是个普通人，但他要做一个不平庸的人。在许许多多不平常的事情中，应该表现出不平常的看法和做法来。—— 《平凡的世界》

When I was young I'd listen to the radio Waitin' for my favorite songs When they played I'd sing along It made me smile Those were such happy times And not so long ago How I wondered where they'd gone But they're back again Just like a long lost friend All the songs I loved so well

Every Sha-la-la-la Every Wo-o-wo-o

Still shines

Every shing-a-ling-a-ling

That they're startin' to sing's So fine

上面分别是引用和嵌套引用的效果。引用使用>号来标记，用来完成对别处文字的引用，嵌套引用使用>>或>>>来标记，增加>个数，可以实现不同层级的嵌套。

8.2 语法格式

引用

>他现在认识到，他是一个普普通通的人，应该按照普通人的条件正正常常的生活，而不要做太多的非分之想。
当然，普通并不等于庸俗。他也许一辈子都是个普通人，但他要做一个不平庸的人。在许许多多不平常的事情
中，应该表现出不平常的看法和做法来。—— 《平凡的世界》

嵌套引用

>你好,我是引用。
>>内嵌引用。
>>>再内嵌。
>>
>>返回到第二层。
>
>返回到第一层。

10 链接

10.1 效果

点击Microsoft Bing进行Bing搜索；点击pixabay进行pixabay美图搜索。

google@gmail.com

www.bing.com/

链接文本放在中括号内，链接地址放在后面的括号中，[链接文本](链接地址")。对于Email和网址地址，可以使用尖括号<>很方便地把url或者email地址变成可点击的链接。

10.2 语法格式

[Microsoft Bing](https://www.bing.com/)
[pixabay](https://pixabay.com/)

<google@gmail.com>
<https://www.bing.com/>

11 特殊符号处理

11.1 效果

特殊符号名称
\反斜杠 backslash
`反引号 backtick
*星号 asterisk
_下划线 underscore
{ }大括号 curly braces
[ ]中括号 brackets
( )小括号 parentheses
<>尖括号 angle brackets
#井号 pound sign
+加号 plus sign
-减号 minus sign (hyphen)
.点号 dot
!感叹号 exclamation mark
|管道符号 pipe

如上表格，对于Markdown特殊字符，在字符前面添加反斜杠字符\进行转译，效果如下： # \ ` * _ { } [ ] ( ) <> + - . ! |

11.2 语法格式

\\  反斜杠 backslash
\`  反引号 backtick
\*  星号 asterisk
\_  下划线 underscore
\{ \}	 大括号 curly braces
\[ \]	 中括号 brackets
\( \)	 小括号 parentheses
\<\>  尖括号 angle brackets
\#  井号 pound sign
\+  加号 plus sign
\-  减号 minus sign (hyphen)
\.  点号 dot
\!  感叹号 exclamation mark
\|  管道符号 pipe

12 脚注

12.1 效果

C语言是一种通用的编程语言，广泛用于系统软件与应用软件的开发。于1969年至1973年间，为了移植与开发UNIX操作系统，由丹尼斯·里奇与肯·汤普逊，以B语言为基础，在贝尔实验室设计、开发出来1。

C语言具有高效、灵活、功能丰富、表达力强和较高的可移植性等特点，在程序设计中备受青睐，成为最近25年使用最为广泛的编程语言2。目前，C语言编译器普遍存在于各种不同的操作系统中，例如Microsoft Windows、macOS、Linux、Unix等。C语言的设计影响了众多后来的编程语言，例如C++、Objective-C、Java、C#等。

12.2 语法格式

Here is a footnote reference[^1] and another.[^2]

[^1]: Here is the footnote.

[^2]: Here's one with multiple blocks.
    Subsequent paragraphs are indented to show that they
    belong to the previous footnote.

Footnotes

  1. zh.wikipedia.org/wiki/C%E8%A… ↩

  2. IOBE Programming Community Index [TIOBE编程社区指数]. 2012 [2012-11-03].（原始内容存档于2018-12-25）（英语）. ↩

avatar
文章
阅读
粉丝