hugo使用提示:
创建新帖子: 使用 Hugo 的 new 命令创建帖子 (这会在 content/post 目录下生成一个 Markdown 文件,文件名以日期开头,便于按日期排序)。如下:
hugo new post/2025-03-13-build-til-blog-by-hugo.md
编辑内容: 打开生成的 Markdown 文件,顶部是前置元数据(front matter),用于定义帖子属性。例如:(就是我当前这篇文章了,呵呵)
title: “从零开始使用 Hugo 搭建 TIL 博客” date: 2025-03-13T14:00:00+08:00 tags: [“til”, “hugo”]
…
title:帖子标题。
date:发布日期,建议使用当前日期,如 2025-03-12。
tags:标签列表,支持多个标签,PaperMod 会自动生成标签页面。
内容部分写在 — 之后,使用 Markdown 语法。
本地开发
- 编辑文章(
content/post/)和配置文件(hugo.toml)。 - 运行
hugo server本地预览,Hugo 会生成public/文件夹供测试。 - 测试完成后,无需保留
public/,它会在下次构建时重新生成。
推送到 GitHub,提交并推送源文件:
git add .
git commit -m "Updated TIL post"
git push | git push -f myblog main
Cloudflare Pages 部署
- Cloudflare Pages 检测到推送后,运行
hugo --minify,生成public/文件并部署。 - 您无需手动干预
public/的内容。
MD语法提示:
引用块(Blockquotes)
引用块用于将文本从其余内容中区分开来,通常用于引用或强调。
基本语法:
使用大于号(>)作为每行引用文本的前缀。
这是一个引用块。 这行也是引用块的一部分。
高级用法:
多层引用:通过增加多个大于号来创建多层引用。
这是第一层引用。
这是第二层引用。
结合其他元素:引用块中可以包含其他Markdown元素,如列表、代码块和链接。
- 这是引用中的列表项
- 这是另一个列表项
注意事项:
引用块后面的文本应该恢复到正常的缩进级别。
引用块的使用应当恰当,过度使用可能会分散读者的注意力。
代码块
代码块用于展示代码或命令行文本。在Markdown中,代码块有两种主要的格式化方式:行内代码和块级代码
。
-
行内代码:
使用反引号(`)将代码包围起来。
这是一个行内代码示例:print("Hello, Markdown")
- 块级代码:
def hello():
print("Hello, Markdown")
指定语言:在开头的三个反引号后指定语言,可以启用代码高亮。
def hello():
print("Hello, Markdown")
高级用法:
长代码块:对于多行代码,使用三个反引号来创建一个代码块是更好的选择。
语法高亮
:通过指定代码的编程语言,可以在支持的Markdown渲染器中启用语法高亮。
注意事项:
确保代码块的开头和结尾都使用了正确数量的反引号。
选择正确的方法(行内代码或块级代码)来展示你的代码,取决于上下文和内容的长度。