使用 astro 和 obsidian 编写博客
2 min read
目录

Astro 模板

Astro 社区有许多精美的 模版 开箱即用,感谢 markhorn-dev 提供了精美简洁的免费模板 astro-nano 。得益于 tailwindcss 的便利性,本博客基于模板做了些许修改,如果有兴趣,请查看前面提到的模板仓库。

Obsidian

obsidian 拥有强大的插件生态编辑 md 文件非常方便,下面会分享几种编写博客过程中常用的插件,以及如何配合 github 和 vercel/netlify 备份和发布博客。

blog 结构如下:

📁 /src/content/blog
└── 📁 post-1
      └── 📄 index.md
└── 📁 post-2
      └── 📄 index.mdx

附件与连接配置

obsidian 配置页面

  1. 新建笔记存放位置:指定的文件夹。
  2. 存放新建笔记的文件夹:指定为博客文件夹:src/content/blog
  3. 内部链接:指定为基于仓库目录的绝对路径(有助于项目路径解析静态资源位置)。
  4. 关闭 Wiki 连接。
  5. 指定附件默认存放文件夹:附件文件夹路径。
  6. 只要保证第三步是基于根目录的绝对路径,这个文件夹可以自定义:public/images

插件配置

Linter

关于格式化 md 文件看个人习惯配置即可,其中需要注意的是:根据 blog 模板的元数据字段(也可以根据自己的需求自定义)配置 yaml 格式化与动填充 yaml 信息。

以上的配置是根据 blog 配置,其中:titledescriptiondatedraft 可以实现每次格式化的时候自动添加。

---
title: "My cool new title"
description: "A description of my content."
date: "Mar 22 2024"
draft: false
---

Git

  1. 关闭自动 commit 和 push。
  2. 自动 git add .git commit 的时间间隔。
  3. 关闭自动拉取:如果多人或多设备编辑需要酌情开启。
  4. 自动拉取的时间间隔。
  5. 自定义自动存档 commit 文案。
  6. 自动以手动存档 commit 文案。
  7. 自定义格式化时间。

工作流

  • 现在配置完成了之后,每十分钟会自动存档一次。
  • 指定命令面板
    • create backup:手动创建存档。
    • push:推送到远程仓库,触发构建。