Hexo+Markdown在你自己的博客发布文章!

1,114 阅读5分钟

引言

原文链接:whitesir-blog.top/posts/25af.…

哈哈,有时候自己在自己搭建的Hexo博客写文章的时候,老是记不住Markdown文档的语法或者怎么新建文章,还有Front-matter 选项怎么去用,所以呢!我就准备自己写一篇文章去记录这些,以免每次写文章都得去百度一大堆东西,本文章不定期更新....

小技巧

新建文章模板修改

首先为了新建文章方便,我们可以修改一下文章模板,建议将/scaffolds/post.md修改为如下代码:

title: {{ title }}
date: {{ date }}
author: 
img: 
coverImg: 
top: false
cover: false
toc: true
mathjax: false
password:
summary:
tags:
categories:
---

这样新建文章后 一些Front-matter参数不用你自己补充了,修改对应信息就可以了

文章 Front-matter 介绍

Front-matter 选项详解

Front-matte1r选项中的所有内容均为非必填的。但我仍然建议至少填写 titledate 的值。

注意:

  1. 如果img属性不填写的话,文章特色图会根据文章标题的hashcode 的值取余,然后选取主题中对应的特色图片,从而达到让所有文章都的特色图各有特色。
  2. date 的值尽量保证每篇文章是唯一的,因为本主题中 GitalkGitment 识别id是通过 date 的值来作为唯一标识的。
  3. 如果要对文章设置阅读验证密码的功能,不仅要在 Front-matter 中设置采用了 SHA256加密的 password 的值,还需要在主题的_config.yml 中激活了配置。有些在线的 SHA256 加密的地址,可供你使用:开源中国在线工具chahuo站长工具
  4. 您可以在文章md文件的 front-matter 中指定 reprintPolicy来给单个文章配置转载规则

以下为文章的 Front-matter 示例。

最简示例

---
title: typora-vue-theme主题介绍
date: 2018-09-07 09:25:00
---

最全示例

---
title: typora-vue-theme主题介绍
date: 2018-09-07 09:25:00
author: 赵奇
img: /source/images/xxx.jpg
top: true
cover: true
coverImg: /images/1.jpg
password: 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92
toc: false
mathjax: false
summary: 这是你自定义的文章摘要内容,如果这个属性有值,文章卡片摘要就显示这段文字,否则程序会自动截取文章的部分内容作为摘要
categories: Markdown
tags:
  - Typora
  - Markdown
---

Markdown

语法

一、参考文档

Markdown 中文版语法说明

Markdown语法图文全面详解(10分钟学会)

Markdown文档编写指南

Markdown Emoji表情语法速查表

Markdown 插入图片或者视频

二、基本语法

标题

注:# 后面保持空格

# h1
## h2
### h3
#### h4
##### h5
###### h6
段落

Markdown划分段落非常简单,就是在段落前后保留一个空行即可,例如:

这是第一个段落内容

这是第二个段落内容

效果如下:

这是第一个段落内容

这是第二个段落内容

区块引用

如果我们需要对一段内容进行强调显示时,Markdown提供了一个特殊符号>(>和内容之前需要空一个空格)用于段落区块引用:

>这是一段引用段落,将会被高亮显示

效果如下:

这是一段引用段落,将会被高亮显示

Markdown支持同时强调引用多个段落,可以按照如下方式书写

> 这是一段引用段落,将会被高亮显示
>
> 这也是一段引用段落,也会被高亮显示

这是一段引用段落,将会被高亮显示

这也是一段引用段落,也会被高亮显示

超链接
[超链接显示文字](http://www.baidu.com "超链接title")


超链接显示文字

提示:超链接title为浮动提示文字,一般情况可以不填写

图片
![百度logo](https://www.baidu.com/img/bd_logo1.png?where=super)

百度logo

图片和超链接的唯一区别就是在最前方添加一个感叹号

无序列表

无序列表使用*、+、-标识,但是一般使用*来标识无序列表

单级列表从最左开始(适用于无序列表)

* 无序列表项
* 无序列表项
* 无序列表项
  • 无序列表项
  • 无序列表项
  • 无序列表项

Markdown支持多级列表嵌套,但是建议一般不使用超过两级列表,另外建议两级列表从缩进3个空格开始(适用于无序列表),如下所示:

   * 无序列表项
      * 第二层列表项
      * 第二层列表项
   * 无序列表项
   * 无序列表项
  • 无序列表项
    • 第二层列表项
    • 第二层列表项
  • 无序列表项
  • 无序列表项

有序列表

有序列表使用数字 .标识

1. 有序列表项1
2. 有序列表项2
3. 有序列表项3
  1. 有序列表项1
  2. 有序列表项2
  3. 有序列表项3
   1. 有序列表项1
      1. 有序列表项11
      2. 有序列表项12
   2. 有序列表项3
  1. 有序列表项1
    1. 有序列表项11
    2. 有序列表项12
  2. 有序列表项3
分隔线
***

---
字体
*这里是文字*
_这里是文字_
**这里是文字**
***这里是文字***
~~这里是文字~~

这里是文字

这里是文字

这里是文字

这里是文字

这里是文字

代码块
行内代码

使用单个反引号进行包裹行内代码,例如 var x = 10

多行代码

可以通过三个反引号将代码包裹起来,反引号单独占一行,多一行单引号后面可以需要添加编程语言,详细的编程语言见pygments.org/languages/

package main

import "fmt"

func main() {
    fmt.Println("Hello, World")
}

表格
| 表头 | 表头 | 表头 |
| ---- | ---- | ---- |
| 内容 | 内容 | 内容 |
| 内容 | 内容 | 内容 |
| 内容 | 内容 | 内容 |
表头 表头 表头
内容 内容 内容
内容 内容 内容
内容 内容 内容

欢迎大家来晚枫博客踩踩!

未完待续......