Hexo + 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写文章
可按照以下步骤编辑一遍博客文章:
- 从官网下载vscode,并安装。
- 安装markdown插件:
- Markdown All in One: 组合包,把最常用的Markdown优化全部装好
- Markdown Preview Github Styling: 在本地就能预览Markdown文件最终在Github Pages中显示的效果
- 学习基本的markdown语法,利用vscode编辑文章。同时,利用”Open Preview to the Side”按键或快捷键可同时预览文章
- 写完这篇文章
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
# 此步骤报错可先检查文件头等文章各部分是否缺少空格