如何仅使用Markdown为Github Pages网站添加自定义图标？

云上老周

2026-8-27

回答

纯基础Markdown本身没有定义全局站点图标（favicon）的原生语法，但你完全不需要手写HTML插入引用标签，依托Github Pages的默认构建规则，有几个跑了很多年的成熟方案，全程不用碰HTML代码，管理成本和纯写Markdown几乎没区别：

零配置自动识别方案（最省事，首推）
把准备好的自定义图标命名为favicon.ico（建议做32*32px的标准尺寸，兼容所有浏览器），直接上传到站点仓库根目录就完事。Github Pages默认构建流程会自动识别根目录下的这个文件，给所有生成的页面自动加上图标引用，后续你正常写Markdown内容就行，半行额外代码都不用加。
踩坑提醒：配置完如果看不到新图标，先按Ctrl+F5（Windows）/Command+Shift+R（Mac）强制刷新清浏览器缓存，favicon的浏览器缓存周期特别长，不清缓存很容易白等半天以为配置没生效。
全局自定义配置方案（支持png/svg等非ico格式）
要是你不想用ico格式，想用png、svg这类更清晰的图标，只需要在仓库根目录新建纯文本文件_config.yml，写一行配置就行：
```
favicon: /你的图标存放路径/自定义图标.png
```
这个配置是Github Pages默认带的Jekyll构建器原生支持的，提交后构建器会自动把图标引用插到所有页面头部，后续要换图标只需要替换文件、改下这行的路径，完全不用碰HTML模板。
单页独立图标方案
如果想给某一篇单独的Markdown页面配专属图标，不用改全局设置，只需要在对应Markdown文件最开头加个元数据块：
```
---
favicon: /单页专属图标路径.svg
---
后面直接正常写你的Markdown正文就行
```
构建的时候系统会自动给这个页面单独加载指定图标，其他页面还是用全局图标，同样不需要写HTML。