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中,代码块有两种主要的格式化方式:行内代码和块级代码

  1. 行内代码:

    使用反引号(`)将代码包围起来。

这是一个行内代码示例:print("Hello, Markdown")

  1. 块级代码:
def hello():
print("Hello, Markdown")
指定语言:在开头的三个反引号后指定语言,可以启用代码高亮。
def hello():
    print("Hello, Markdown")

高级用法

    长代码块对于多行代码使用三个反引号来创建一个代码块是更好的选择
    语法高亮

    通过指定代码的编程语言可以在支持的Markdown渲染器中启用语法高亮

注意事项

    确保代码块的开头和结尾都使用了正确数量的反引号
    选择正确的方法行内代码或块级代码来展示你的代码取决于上下文和内容的长度