实战场景

Markdown + GitHub Pages 免费搭建个人网站/博客/文档

不想花一分钱买服务器,又想要一个属于自己的网址?如果你已经在用 Markdown 写东西,GitHub Pages 几乎是门槛最低、最稳的免费建站方案。

一、GitHub Pages 是什么

GitHub Pages 是 GitHub 提供的静态网页托管服务:你把 HTML、CSS、JS 这些静态文件推到仓库,GitHub 就帮你生成一个 https://用户名.github.io 的网址,全世界都能访问。它不跑后端程序、不连数据库,所以免费、快、还不容易挂。

这对“写 Markdown 的人”特别友好——Markdown 本身就是为生成静态网页而生的,两者几乎天生一对。

二、为什么 Markdown 用户最适合

你已经有内容资产了。平时用 Markdown 记的笔记、写的教程、整理的文档,只要再走一步“渲染成网页”,就能变成公开的站点。相比从零学 HTML:

  • 写作成本低:继续用你熟悉的 # 标题、- 列表,不用管布局。
  • 版本可追溯:每次改动都进 Git 历史,误删、想回滚都有据可查。
  • 纯文本好迁移:哪天想换平台,把 .md 文件带走即可,不被绑定。
  • 零运维:不用买服务器、配环境,GitHub 帮你托管和发 HTTPS。

小技巧:先把内容在 365Lab 在线编辑器 里写顺、预览满意,再导出或复制进仓库,效率最高。

三、三种建站方式怎么选

1. 手动上传 HTML(最简单)

直接把写好的网页文件拖进仓库。适合只想放一个简单主页或单页简历的人。缺点是要自己写/维护 HTML。

2. 静态网站生成器(最主流)

用 Jekyll、Hugo、Astro、VitePress 这类工具,你只写 Markdown,工具帮你生成整套带导航、搜索、分页的站点。其中 Jekyll 被 GitHub Pages 原生支持,配置最少。

3. 纯 Markdown 直出(极简)

有些方案(如 mdBook、MkDocs)专门把一堆 Markdown 变成文档站/电子书,几乎零配置。适合写产品文档、教程合集。

方式上手难度适合是否需本地构建
手动 HTML低单页主页/简历否
Jekyll中博客/文档站否(GitHub 构建)
Hugo/Astro中高大型站点是
MkDocs/mdBook低技术文档是

四、从零搭建一个文档站

下面用“最少配置”的 Jekyll 路线演示,GitHub 会替你构建,本地无需安装 Ruby。

步骤 1:新建仓库

在 GitHub 新建一个名为 用户名.github.io 的公开仓库(用户名要和你 GitHub 账号一致),这个仓库名就是你的网址。

步骤 2:放一个 Markdown 文章

在仓库里新建 index.md,开头写一段“前置信息”(front matter),告诉 Jekyll 怎么处理:

---
title: 我的主页
layout: default
---

# 你好,这是我的站点

用 Markdown 写的内容会自动变成网页。
- 支持列表
- 支持 **加粗**
- 支持 [链接](/about)

步骤 3:加一个配置文件

新建 _config.yml,至少写一行主题:

theme: jekyll-theme-minimal

步骤 4:推送并等待

把文件推到 main 分支,GitHub 会在后台构建。一两分钟后访问 https://用户名.github.io 就能看到页面。构建状态可在仓库的 Actions 标签页查看。

注意:仓库必须是 Public(免费版),且分支设为 GitHub Pages 的发布源(默认就是 main 根目录)。

五、自定义域名与 HTTPS

不想用 github.io 结尾?可以绑定自己的域名(如 blog.你的名字.com):

  1. 在域名服务商处加一条 CNAME 记录,指向 用户名.github.io。
  2. 在仓库 Settings → Pages → Custom domain 填入你的域名。
  3. GitHub 会自动签发并续期 HTTPS 证书,免费且不用你管。

绑定后建议勾选 “Enforce HTTPS”,让所有访问都走加密连接——这也有利于搜索排名。

六、常见问题

Q:完全不懂 Git 能建吗?
A:能。GitHub 网页端可以直接新建/编辑文件、点 “Commit” 保存,不用装任何命令行工具。内容先在本地的 365Lab 编辑器 写好再粘贴最省事。

Q:GitHub Pages 收费吗?
A:公开仓库的 Pages 完全免费,带宽对个人站点足够。私有仓库也能用,但个人用途免费额度已很宽裕。

Q:能放图片和下载文件吗?
A:能。把图片放进仓库,用相对路径引用即可;具体图片写法见 Markdown 插入图片。大文件建议用图床或对象存储。

Q:和写 README 有什么关系?
A:README 也是 Markdown,很多项目的文档站就是由 README 和 /docs 下的 Markdown 自动生成的。想系统学文档写法,看 Markdown 写 GitHub README。


想先有一份可复制的文档内容?用 Markdown 导出 HTML 把稿件转成网页素材;团队一起维护文档可参考 Markdown 团队协作;新手从 Markdown 入门 起步最稳。想用生成器把一堆 Markdown 变成完整站点,看 Markdown 静态网站生成器怎么选。

先把内容写顺,再上线

用 365Lab 在线编辑器把 Markdown 写好、预览满意,再复制进仓库,建站最省心。免注册、内容本地保存。

免费开始写作 →