管窥程序

Today is a gift

0%

Hexo Markdown 语法说明

发表于 更新于 分类于 阅读次数： Valine：

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. 个
  2. 订单
  3. 大

表格

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

  • 左对齐 :----
  • 居中 :—:
  • 右对齐 ----:
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. 现代化，人性化，人民的幸福指数高 ↩︎