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 |
|
tags:
节点中,如果有多个标签:
1 | # 单一标签 |
categories:
节点也是如此:
1 | #单一类别 |
上面的Web
是Computer
的子类,如果需要多个分类,用下面list中的方法:
categories:
- [Computer, Web]
- [Computer, Games]
- [Life]
此时这盘文章同时包括三个分类:Web
和Games
分别都是父类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 | 切换侧边预览 |