Markdown博客文章写作最佳体验，hugo+Obisidian+Vscode

2022-09-11 约 1269 字预计阅读 3 分钟 - 次阅读 - 条评论

警告

本文最后更新于 2022-09-12，文中内容可能已过时。

前言

hugo博客搭建后，博客写作和发布流程较为复杂，因为是静态博客，每次都需要重新编译。不过，通过GitHub action，我们已经把这步交给GitHub去做了。我们只需提交即可触发自动编译并发布到你部署的平台，我目前托管在GitHub pages，vercel，render，netlify这四个平台上，不过8月下旬起vercel提供*.vercel.app域名已经被墙，我开启了独立域名 https://zhjin.eu.org 。

现在我们的整体写作流程如下：

通过命令hugo new posts/文章名.md 新建一篇文章。
用Markdown编辑器进行写作，图片资源本地存储或引入图床
上传文章，自动发布

这个过程稍微还是繁琐了一些，因此，怎么优化这个这个流程，把写作体验提升变得尤为重要。

obisidian

1.obisidian简介

Markdown编辑器，市面上口碑不错的有typora，vscode，obisidian。不过typora从2021-11-23号起已经开始收费。obisidian也是最近才发现的一款神器，使用体验下来也非常不错。

obisidian是什么，这里简单介绍一下。

一款离线的笔记软件（现在也推出收费云服务）
markdown编辑工具，实时预览
文件都在本地存储
文件夹式管理
支持文件链式关联

它可以智能生成文档关系图谱，记忆保存你上次打开的文件位置，界面简洁，文件夹式管理，不同文件可以链式关联，拥有丰富的插件。如果想要跨设备云同步，可以借助第三方云盘，比如坚果云。

2.新建文章

借助obisidian的插件QuickAdd，我们可以把新建文章的步骤进行优化，做成一个快捷指令。

在博客根目录，新建文件夹obs_sctipts，里面添加新建脚本NewBlog.js，内容如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
const util = require("util");
const child_process = require("child_process");
const exec = util.promisify(child_process.exec);

//新建博客命名，这里以年月日时分秒命名，可自定义修改
function getCreateTimeAsFileName() {
  var d = new Date();
  var year = d.getFullYear();
  var month = d.getMonth() + 1;
  var day = d.getDate();
  var hour = d.getHours();
  var minute = d.getMinutes();
  var second = d.getSeconds();
  var time =  year + "-" + month +"-" + day +  "day" + hour +  "h" + minute +  "m" + second +  "s";

  return time;
}


// execute command function

async function executeCommand() {
  const fileName = getCreateTimeAsFileName() + ".md";
  const { stdout, stderr } = await exec("hugo new posts/" + fileName, {
    cwd: app.fileManager.vault.adapter.basePath,
  });
  console.log("stdout:", stdout);
  console.log("stderr:", stderr);
  if (stdout) {
    new Notice("New Blog Created[" + fileName + "]");
  } else {
    new Notice("New Blog Create Faild. " + stderr);
  }
}

module.exports = async function (context, req) {
  await executeCommand();
};

进入设置-第三方插件-关闭安全模式，浏览插件，安装QuickAdd插件。
QuickAdd插件，点击它的设置，新增一个宏定义，输入框输入【新建博客】-Macro-add Choice，这时你就可以看见增加了新建博客的宏定义，闪电符号点击勾选，这里是创建命令的意思。
创建完【新建博客】的宏定义后，点击下面Manage Macros-Configure 进行设置，User Scripts 找到脚本NewBlog 脚本，add添加。完成。
通过以上设定，你已经完成新建文章的快捷方式配置，按快捷键ctrl+p，调起命令面板，输入quickadd，就能看到新建博客的快捷按钮，我这里截图的两个都一样，步骤1中勾选闪电符号，就是在这里创建这个快捷命令QuickAdd：新建博客，点击就可看到新建博客成功。