目录
什么是GitHub Pages？
GitHub Pages是一个可以托管静态网页的服务，利用GitHub提供的仓库管理功能，你可以轻松地创建和发布网站。无论是个人项目展示、技术文档，还是博客，GitHub Pages都可以帮助你实现。
Markdown基础知识
Markdown是一种轻量级的标记语言，特别适合编写格式化文本。由于其简洁的语法，Markdown广泛应用于文档撰写、代码注释和网页内容等。
Markdown的基本语法
- 标题: 使用
#来表示标题级别，例如# 一级标题,## 二级标题 - 强调: 用
*斜体*或**加粗** - 列表: 使用
-或*来创建无序列表；使用数字加点创建有序列表 - 链接: 使用
[链接文本](链接地址)的格式 - 图片: 使用
Markdown的优点
- 简洁易学
- 格式清晰
- 与HTML兼容
如何在GitHub上设置Pages
创建GitHub账户
- 访问 GitHub官网
- 注册一个新的账户
- 登录后进入你的个人主页
创建新的仓库
- 点击右上角的
+符号，选择New repository - 输入仓库名称（例如
my-site），选择Public - 勾选
Initialize this repository with a README，然后点击Create repository
启用GitHub Pages
- 在仓库主页，点击
Settings - 向下滚动到
GitHub Pages部分 - 在
Source下拉框中选择main或master分支 - 保存设置，GitHub将生成一个URL，用于访问你的页面
使用Markdown撰写内容
创建Markdown文件
在仓库中，创建一个新的文件，例如 index.md，并用Markdown格式编写内容。你可以添加一些基本信息，例如：
markdown
这是我的个人网站，记录我的学习和成长。
我的项目
- 项目1
- 项目2
预览Markdown文件
在GitHub上，你可以直接预览Markdown文件，确保格式正确。
自定义GitHub Pages
主题和布局
GitHub Pages支持多种主题和自定义布局，你可以使用Jekyll来进一步美化你的网页。
- 在仓库中创建
_config.yml文件 - 添加主题信息，例如： yaml theme: minima
添加导航
你可以通过添加链接到其他页面来创建网站导航。
部署和更新网站
一旦你创建了内容并进行了必要的设置，你的GitHub Pages网站就可以访问了。只需将文件提交到主分支，网站会自动更新。
常见问题解答
如何使用Markdown创建GitHub Pages？
只需在你的GitHub仓库中创建一个Markdown文件，并确保你的GitHub Pages功能已启用。
GitHub Pages支持哪些文件类型？
GitHub Pages主要支持HTML、Markdown和Jekyll文件。
GitHub Pages的URL是什么？
通常是 https://<username>.github.io/<repository>，其中 <username> 是你的GitHub用户名，<repository> 是你的仓库名称。
如何更改GitHub Pages的主题？
在 _config.yml 文件中指定所需主题即可。可以选择多种可用的Jekyll主题。
如何在GitHub Pages上添加自定义域名？
你需要在GitHub设置中添加自定义域名，并在你的域名注册商处设置DNS记录。
正文完
