如何在博客中发布一篇文章

格式要求

必须格式

开头部分需要添加一些yaml配置，作为网站解析这篇文章的标准，必须要加入的是下面这部分。

---
title: TITLE
date: YYYY-MM-DD HH:MM:SS +/-TTTT
categories: [TOP_CATEGORIE, SUB_CATEGORIE]
tags: [TAG]     # TAG names should always be lowercase
---

额外选项

1. description:用于添加描述
2. toc：用于控制是否启用目录，默认开启。可以通过 toc:false 关闭
3. comments：可以通过同样的方式关闭评论。评论设置在_config.ymal的 comments.provider里

媒体部分

如何正确的添加图片

我最初尝试将图片都放在一个文件夹里,之后通过相对路径链接,但是失败了.看到解决方法是要在github上找到具体路径添加.

• 把需要插入的图片保存到images文件夹里并push到github远程仓库
• 在github仓库中打开图片，复制url，如 https://github.com/18241950925/18241950925.github.io/blob/main/images/2024-12-26-modern%20C%2B%2B/image-1.png
• 将URL中blob替换为raw，即 https://github.com/18241950925/18241950925.github.io/raw/main/images/2024-12-26-modern%20C%2B%2B/image-1.png
• 使用markdown插入图片的语法即可显示图片

ps:有帖子说相对路径也是可以的,我最终发现失败的原因是一个代码片段没有加代码块引用,被识别为html代码引发报错

参考文章

官方教程