0%

Hexo Markdown 语法说明

markdown 俨然成为了写作神器,这篇文章是刚开始学时写的,到现在我已经熟练的应用了(2020年7月24日)

斜体和粗体

斜体用 * ,粗体用 **

这是斜体 这是粗体

标题

  • 一级标题用 # 或者在下一行用至少一个=
  • 二级标题用 ## 或者在下一行用至少一个-
  • 三级标题用 ###
  • 一直到六级标题用六个 #
  • 注意# 和后面标题之间有个空格
  • 没有六级以后的标题了

例如

一级标题

这也是一级标题

二级标题

这也是二级标题

三级标题

这是四级标题

这是五级标题
这是六级标题

####### 有没有七级标题 看来是没有了

分隔线

在单独的一样用 *** 或者 — 来表示

我是分隔线— 注意这个分隔线可能和二级标题有冲突,所有需要和上面的文字隔至少一个空行


我是分隔线***


删除线

~~来表示,需要在被删除文字的两端都加 例如 我被删除了

超链接

普通链接

语法是[链接文字](链接地址 "链接标题")

例如 这是我的博客

图片

那么图片如何插入呢

语法是![图片说明](图片地址 "图片标题") 注意和链接的区别是前面加了一个!

例如 这是个美女吧
这个感觉很大,能缩小吗?找了一下 说直接用 html的图片语法好了图片部分的参考对吧

也就是说如果不知道怎么表示的话,就直接上html吧

音频

当然也可以插入音频 语法如下

1
{% aplayer title author url [picture_url, narrow, autoplay, width:xx%, lrc:xxx] %}

这个不作演示了, 可参考hexo-tag-aplayer 说明的很详细

视频

如果还想插入视频的话,就用原生的iframe吧

自动链接

对于像邮箱地址之类的特殊链接,直接使用 <> 来实现超链接效果,例如

1
请联系我: <mymail@oneexample.com>

显示为请联系我: mymail@oneexample.com

注释

注释指的是有其后面的内容不受markdown语法控制 用 \ 来表示不是有没所有的内容,而是紧跟其后的markdown标记,例如想原样显示几个*号 需要这样写,\****

例如***

例如
## 我是个这是不是二级标题 **我也不能加粗**

引用

引用用 >来表示,如果成段引用的话,段落里的文字行与行之间要没有空行,如果有就需要在空行和后面第一行加上>,否则会不成为一个整体引用

例如

我是引用的内容值得注意的是不同的markdown解释引擎对相同的语法标记解释是不同的

和上面的引用是一起的

注脚

语法: 用[^1] 来加注脚,必须为数字
在任意位置,进行注脚说明

例如:
我们国家[^1],是个美好国家[^2]
[^1]:中国
[^2]:现代化,人性化,人民的幸福指数高

显示效果如下

我们国家[1],是个美好国家[2]

编译器会自动将注脚整理到文档尾部,点击上面的注脚试试

注意

  • 注脚并非Hexo默认支持的Markdown语法,使用前需要按照插件hexo-reference
  • 另外这个设置了注脚,必须写对应的注脚说明,否则编译会出错

列表

使用 * + -来表示无序列表

例如

1
2
3
4
- 要做什么
- 能怎么做
- 为什么
- 层次
  • 要做什么
  • 能怎么做
  • 为什么
    • 层次

数字和点来表示有序列表,数字是几不重要
例如

1
2
3
1. 个
1. 订单
5. 大
  1. 订单

表格

| 控制分列,- 空分行, : 控制对齐方式

  • 左对齐 :----
  • 居中 :—:
  • 右对齐 ----:
1
2
3
4
5
| Item     | Value     | Qty   |Point|
| :------- | --------: | :---: |--- |
| Computer | 1600 USD | 5 | 5|
| Phone | 12 USD | 12 |6|
| Pipe | 1 USD | 234 | &nbsp;|
Item Value Qty Point
Computer 1600 USD 5 5
Phone 12 USD 12 6
Pipe 1 USD 234  

可以写的比较随意,但为了自己能看清楚,写好些是有必要的
如果是最末的一个单元格,且为空时,需要用占位符,否则可能会缺失

代码块

行内代码块

<code> </code> 标签来表示这是行内代码
也可以用 ``来表示吧,需要验证下
我也是行内代码 看来是有效的

多行注释

用 两行 ``` 来将代码快括起来表示,
第一行的 ``` 紧跟其后可以声明代码语言

例如

```js
function a(){
  console.log(“Hello world!”);
}
```

javascript:

1
2
3
4
5
6
/*
* Hello world test
*/
function a(){
console.log("Hello world!");
}

python:

1
2
3
4
5
6
7
8
9
10
11
12
# requires_authorization
def somefunc(param1='', param2=0):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2 - param1 + 1) or None

class SomeClass:
pass

>>> message = '''interpreter
prompt'''

特殊点

首行缩进

使用占位符

  • 半角:&ensp; 或者 &#8194;
  • 全角:&emsp; 或者 &#8195;
  • 空格:&nbsp;相当于1/4角

例如:
 我是缩进一个半角的
 我是缩进一个全角的
 我只缩进了一个空格

不隔行换行

  1. 使用Html标记 <br>
  2. 在上一行结尾敲2个或者以上的空格

例如:
我们来自不同的国家
中国、美国、日本,还有朝鲜

参考文档


  1. 中国 ↩︎

  2. 现代化,人性化,人民的幸福指数高 ↩︎