嘿!想拥有一个既极速又极简,还完全免费的个人博客吗?
很多小伙伴被“部署”、“服务器”、“域名”这些词吓到了。其实,利用 Hugo(世界上最快的静态网站生成器) 和 GitHub(全球最大的代码托管平台),你只需要动动手指,就能拥有一个专属的互联网小家。
今天这篇教程,就是专门为“小白”准备的避坑指南。
一、 为什么选择 Hugo + GitHub?
- 快: Hugo 生成页面的速度是以“毫秒”计算的。
- 省: GitHub Pages 提供的托管服务完全免费,连服务器钱都省了。
- 稳: 只要 GitHub 不倒闭,你的博客就永远在线。
- 酷: 纯文本写作,像程序员一样记录生活。
二、 准备工作(你需要准备什么)
在开始之前,请确保你已经:
- 注册了一个 GitHub 账号。
- 在电脑上安装了 Git 和 Hugo(如果还没装,可以去官网下载,一路“下一步”即可)。
三、 实战步骤
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
这是最关键的一步。
- 在 GitHub 上新建一个仓库,名字叫:你的用户名.github.io(例如 zhangsan.github.io)。
- 在本地博客根目录,关联这个仓库并推送:
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,你可以摆脱社交平台的束缚,拥有一个完全属于自己的思考空间。