Hexo + Markdown写博客

创建、发布新文章;用vscode + markdown编辑文章;给文章添加分类和标签。

新建文章 create a post

在博客目录运行命令:

$ hexo new [layout] title
# layout有三种:post, draft, page, 默认是post,可以在博客配置文件中更改default_layout来更改默认设置
# Hexo会根据scaffolds文件夹内相对应的文件来建立md文件
# 当创建不同布局的md文件时,它们会存储在不同路径

$ hexo new "My New Post"
#新建一个名为"My New Post"的md文件

后续编辑这个文件即可。

vscode + markdown写文章

可按照以下步骤编辑一遍博客文章:

  1. 官网下载vscode,并安装。
  2. 安装markdown插件:
    • Markdown All in One: 组合包,把最常用的Markdown优化全部装好
    • Markdown Preview Github Styling: 在本地就能预览Markdown文件最终在Github Pages中显示的效果
  3. 学习基本的markdown语法,利用vscode编辑文章。同时,利用”Open Preview to the Side”按键或快捷键可同时预览文章
  4. 写完这篇文章

categories

生成categories页并修改type属性

在博客目录运行命令行:

1
$ hexo new page categories

运行成功后会提示:

INFO  Created: ~/Documents/blog/source/categories/index.md

根据所给路径找到index.md文件,在文件的框架内添加一行:

type: "categories"

给文章添加categories

在文章头的categories:后以-为标志添加标签,如本文的标签:

categories:
- Blog #注意“-”后一定要加空格

tag

生成tag页并修改type属性

在博客目录运行命令行:

1
$ hexo new page tags

运行成功后会提示:

INFO  Created: ~/Documents/blog/source/tags/index.md

根据所给路径找到index.md文件,在文件的框架内添加一行:

type: "tags"

给文章添加tag

在文章头的tags:后以-为标志添加标签,如本文的标签:

tags: 
- Blog #注意“-”后一定要加空格
- Hexo
- Markdown
- vscode

文章的发布

在博客目录运行命令:

$ hexo generate
$ hexo server  # 本地预查看
$ hexo deploy  # 部署到GitHub Pages

# 此步骤报错可先检查文件头等文章各部分是否缺少空格

参考

  1. Hexo博客写文章及基本操作
  2. Hexo使用攻略-添加分类及标签
  3. [Markdown] 使用vscode开始Markdown写作之旅