vscode+hexo

当我确定了用md格式记录笔记,并且使用hexo发布的时候,我开始着手准备我的工具。这十几年我一直使用印象笔记在同步我的信息,用wordpress搭建博客,但印象笔记的笔记好像无法连同格式复制到wordpress当中,并且随着印象笔记的没落,似乎官方也在2023年以后不在更新它的各种媒体信息,而我的会员虽然还有很久才到期,现在却也开始准备保存到本地了。目前还没有找到好的导出方案

笔记软件我选择了obsidian,可不管说的多神气,对于我这种刚开始准备写几个字的人来说,不需要那么多功能,在之前修改笔记的时候,恰巧我用vscode打开,同时安装了Markdown All in One这个插件后,这不也挺好的么,在反复用hexo发布笔记并且调整格式的时候,安装了markdownlint用来调整markdown的格式,一次性就把格式弄好了,那我为什么还要在多安装一个软件呢?看来vscode就够了。仅以此笔记,记录一下用vscode写hexo的方法。

Hexo的写作方式

按照Hexo 官方文档的说明,创建新文章的命令如下:
$ hexo new [layout] <title>
其中:

  • layout: 新文章的指定布局,默认post布局,其余两个布局分别是draft和page。
  • title: 标题,标题中有空格的时候,必须包围在一对半角双引号中。

关于Hexo的模板

Hexo自动套用scaffolds\post.md模板来生成post格式的文件,而Hexo的文章一般需要的内容如下:

1
2
3
4
5
6
7
8
---
title: {{title}}
date: {{date}}
updated: {{date}}
tags:
categories:
keywords:
---

tags:节点中,如果有多个标签:

1
2
3
4
5
6
# 单一标签  
tags: hexo
# 多个标签
tags:
- hexo
- git

categories:节点也是如此:

1
2
3
4
5
6
#单一类别  
categories: Computer
#多个类别
categories:
- Computer
- Web

上面的WebComputer的子类,如果需要多个分类,用下面list中的方法:

categories:  
- [Computer, Web]
- [Computer, Games]
- [Life]

此时这盘文章同时包括三个分类:WebGames分别都是父类Computer的子类,同时Life是一个没有子分类的分类

drafts文件存在source\_drafts文件夹中,page页面存放在source文件夹中。

hexo n draft "my-idea"来创建一篇草稿,同时也可以用hexo publish "my-idea:命令将草稿从source_drafts中转移到source_post中,并自动填写发布日期。

也可以在站点配置中,把default_layout设置成draft,这样运行hexo n "<filename>"命令将直接创建草稿。

使用Visual Studio Code撰写文章

启动VS Code,选择 文件|打开文件夹 打开站点文件夹。

按下Ctrl+`激活VS Code下方的“终端”面板,并输入hexo n "myblog"并回车。

Hexo的简化命令,hexo n相当于hexo new,hexo s相当于hexo server,所以在目录中建立.bat文件:hexo clean && hexo g && hexo d

按下Ctrl+P激活VS Code的“快速打开”面板,并输入刚刚创建的文件名myblog并回车。

预览文章可以按下Ctrl+K,V打开VS Code自带的Markdown预览窗口。

整体预览可以激活终端并执行hexo s -o,启动Hexo本地服务器并自动在默认浏览器打开(这是-o选项的效果)

有用的插件

markdownlint

markdownlint是一个Markdown语法检查其,不符合Markdown规范的内容将被标上波浪线,并提供相应的改进提示。

tips: 按下Ctrl+Shift+X在侧边栏打开“扩展”面板,输入扩展名称即可自动搜索。

Markdown All in one

快捷键 命令
Ctrl/Cmd + B 切换加粗
Ctrl/Cmd + I 切换斜体
Alt+S (Windows) 切换删除线
Ctrl + Shift + ] 切换标题(上级)
Ctrl + Shift + [ 切换标题(下)
Ctrl/Cmd + M 切换数学环境
Alt + C 勾选/取消勾选任务列
Ctrl/Cmd + Shift + V 切换预览
Ctrl/Cmd + K V 切换侧边预览