嘿!想拥有一个既极速又极简,还完全免费的个人博客吗?

很多小伙伴被“部署”、“服务器”、“域名”这些词吓到了。其实,利用 Hugo(世界上最快的静态网站生成器)GitHub(全球最大的代码托管平台),你只需要动动手指,就能拥有一个专属的互联网小家。

今天这篇教程,就是专门为“小白”准备的避坑指南。


一、 为什么选择 Hugo + GitHub?

  1. 快: Hugo 生成页面的速度是以“毫秒”计算的。
  2. 省: GitHub Pages 提供的托管服务完全免费,连服务器钱都省了。
  3. 稳: 只要 GitHub 不倒闭,你的博客就永远在线。
  4. 酷: 纯文本写作,像程序员一样记录生活。

二、 准备工作(你需要准备什么)

在开始之前,请确保你已经:

  1. 注册了一个 GitHub 账号。
  2. 在电脑上安装了 GitHugo(如果还没装,可以去官网下载,一路“下一步”即可)。

三、 实战步骤

1. 本地创建博客

打开终端(Windows 的 PowerShell 或 Mac 的 Terminal),输入:

hugo new site my-blog
cd my-blog

2. 挑选一个“皮肤”(主题)

没有皮肤的博客是不完整的。我们以经典的 PaperMod 为例:

git init
git submodule add --depth=1 [https://github.com/adityatelange/hugo-PaperMod.git](https://github.com/adityatelange/hugo-PaperMod.git) themes/PaperMod
echo "theme = 'PaperMod'" >> hugo.toml

3. 写下第一篇文章

hugo new posts/hello-world.md

打开生成的 content/posts/hello-world.md,随便写点什么。

4. 推送到 GitHub

这是最关键的一步。

  1. 在 GitHub 上新建一个仓库,名字叫:你的用户名.github.io(例如 zhangsan.github.io)。
  2. 在本地博客根目录,关联这个仓库并推送:
git commit -m "初次建站"
git branch -M main
git remote add origin [https://github.com/你的用户名/你的用户名.github.io.git](https://github.com/你的用户名/你的用户名.github.io.git)
git push -u origin main

5.开启自动化部署(GitHub Actions)

现在最流行的做法是使用 GitHub Actions。你只需要在 GitHub 仓库的设置(Settings -> Pages)里,把 Build and deployment 的源改为 GitHub Actions。

GitHub 会自动识别 Hugo 项目并帮你把网页“变”出来。几分钟后,访问 https://你的用户名.github.io,奇迹就发生了!

四、 掌握写作利器:Markdown (MD)

既然用了 Hugo,你就必须学会用 Markdown 写作。这是一种“所见即所得”的轻量级标记语言。

为什么大家都爱 Markdown? 专注于文字: 你不需要纠结字体大小、行间距,写完即排版。

跨平台: 任何编辑器都能打开,不会像 Word 文档那样格式错乱。

代码友好: 插入代码块非常漂亮,适合技术人。

常用命令“小抄” 如果你是第一次使用,记住下面这几个就够用了:

效果 Markdown 语法
一级标题 # 标题名字
二级标题 ## 标题名字
加粗 **这是粗体**
斜体 *这是斜体*
超链接 [文字](链接地址)
插入图片 ![描述](图片地址)
无序列表 * 列表项
引用代码 代码内容

温馨提示: 在 Markdown 中,所有的符号(如 #、*、!)后面都要加一个空格,这样格式才最标准。

五、 结语

搭建博客只是第一步,持续的输出才是灵魂。

利用 Hugo,你可以摆脱社交平台的束缚,拥有一个完全属于自己的思考空间。