MD 建站主流工具：VitePress / Hugo / Astro / Hexo / Docsify / VuePress，核心优势是纯静态 HTML、加载快，但默认缺失大量 SEO 基础配置，下面分MD 文件内容层、Frontmatter 页面元数据、站点技术 SEO、站内链接、性能、收录提交、避坑7 大块实操方案，可直接落地。
一、Markdown 正文内容 SEO（写 MD 时同步规范）
1. 标题层级（核心，爬虫识别内容结构）
严格层级不跳级，一篇文章仅 1 个# H1（页面主标题）：
# H1 主标题（含核心关键词，对应页面title） ## H2 二级小标题（长尾关键词） ### H3 三级细分 禁止：# 直接跳 ###，破坏页面权重结构
- H1 = Frontmatter 里的 title，保持一致
- 全文关键词自然分布在 H1/H2 / 首段 / 结尾，堆砌会降权
2. 正文关键词布局
- 首段前 100 字植入主关键词+1 个长尾词
- 全文 2–3% 关键词密度，每 300 字出现 1 次
- 文末小结再次点题关键词
3. 图片 SEO（MD 图片标准写法）
所有图片必须写alt替代文本，图片搜索流量来源：
规范：
- alt 包含关键词，描述图片内容，不写
图片1 - 图片统一压缩 WebP，本地 TinyPNG 批量处理
- 图片路径用相对 / CDN 绝对地址，不本地磁盘路径
- 大图加懒加载（SSG 模板统一开启）
4. 列表、代码、内链规范
- 重要知识点用有序 / 无序列表，爬虫更喜欢结构化文本
- 代码块减少大段无注释代码，添加文字说明
- 相关文章站内互链：
[MD静态站sitemap配置](./sitemap.md) - 外部链接统一加
nofollow，避免权重流失
5. 分页、分类、标签 MD 文件
单独创建tags/xxx.md、category/xxx.md归档页，聚合同主题文章，提升页面收录量。
二、Frontmatter 头部元数据（每篇 MD 必写 TDK）
所有 SSG 都支持 YAML 头部，控制页面title/description/OG/收录规则，通用标准模板：
--- # TDK核心SEO title: Markdown文件直接建站SEO优化完整实操教程2026 # ≤60字符，主关键词+年份 description: 一文搞定MD静态站SEO，含VitePress/Hugo frontmatter、sitemap、robots、内链、图片、收录全流程优化方案 # 150–160字符，转化型描述 keywords: Markdown建站,静态站SEO,VitePress优化,Hugo sitemap # 3–5个词 # 内容属性 date: 2026-07-07 # 发布时间，爬虫抓取更新 updated: 2026-07-07 # 更新时间（重要，展示时效性） author: 作者名 category: 建站教程 tags: ["Markdown","SEO","静态网站"] # 收录控制（按需） robots: index,follow # noindex,nofollow 用于草稿/分页/隐私页 canonical: https://xxx.com/md-seo.html # 标准化URL，解决重复内容 # 社交分享OG标签（解决微信/抖音预览空白） ogTitle: Markdown文件直接建站SEO优化完整实操教程2026 ogDesc: 一文搞定MD静态站SEO，含VitePress/Hugo frontmatter、sitemap、robots、内链、图片、收录全流程优化方案 ogImage: https://xxx.com/img/md-seo-cover.webp # 封面图绝对地址 ogType: article ---
关键字段说明
- canonical 标准化链接
解决重复内容：带斜杠 / 不带斜杠、www / 非 www、分页、多端镜像，统一指向唯一标准 URL。 - robots
草稿页、标签分页、搜索页设置noindex，避免大量低质页面挤占收录预算。 - OG 标签必须填完整绝对 URL，相对路径社交爬虫不识别。
三、站点全局技术 SEO（SSG 统一配置，一劳永逸）
1. 干净扁平化 URL（静态站最大优势）
禁止中文 URL、id 数字、多层嵌套、.html后缀：
差：/post/2026/07/123.html
优：/md-build-seo/
配置方式：
- Hugo：
permalinks全局设置英文 slug - VitePress/Astro：frontmatter 添加
permalink: "/md-build-seo/"
文件名统一用英文短横线：md-seo.md，不用Markdown建站.md
2. 自动生成 sitemap.xml（必开）
所有主流 SSG 有插件一键生成全站地图，告知爬虫所有页面：
- VitePress：
vitepress-plugin-sitemap - Hugo：内置 sitemap 模板
- Hexo：hexo-generator-sitemap
- Astro：内置 content 集合自动生成
生成后在robots.txt引入：
Sitemap: https://xxx.com/sitemap.xml User-agent: * Allow: / Disallow: /admin/ Disallow: /draft/
3. robots.txt 放在站点根目录
通用模板（国内百度 + 谷歌通用）：
# 允许所有爬虫 User-agent: * Allow: / # 屏蔽草稿、后台、资源目录 Disallow: /draft/ Disallow: /temp/ Disallow: /search? # 站点地图地址 Sitemap: https://你的域名/sitemap.xml
4. 移动端适配（基础排名门槛）
全局 HTML 头部强制添加 viewport，SSG 全局 head 配置：
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0"> <meta http-equiv="X-UA-Compatible" content="IE=edge">
5. 面包屑结构化数据（提升搜索展示）
模板统一加入BreadcrumbList微数据，百度 / 谷歌会展示面包屑路径，增加点击率。
示例（VitePress/Hugo 模板注入）：
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{"@type":"ListItem","position":1,"name":"首页","item":"https://xxx.com/"},
{"@type":"ListItem","position":2,"name":"建站教程","item":"https://xxx.com/category/build/"},
{"@type":"ListItem","position":3,"name":"MD建站SEO","item":"https://xxx.com/md-seo/"}
]
}
</script>
6. 文章结构化数据 Article Schema
每篇文章页面注入，搜索引擎展示发布时间、封面、作者、评分：
- type 固定
Article - 填入标题、封面图、发布更新时间、正文摘要
四、站内链接优化（提升爬虫抓取深度）
- 侧边栏导航 \[_sidebar.md](_sidebar.md)（Docsify/VitePress）
所有页面可直达，爬虫抓取入口变多：
* [首页](/) * [MD建站SEO](./md-seo.md "Markdown建站SEO教程") * [Sitemap配置](./sitemap.md)
括号内双引号为锚文本 title，辅助 SEO。
2. 上下篇、相关文章模块
模板自动渲染同标签 / 同分类文章，增加页面内链密度。
3. 锚文本多样化
不要统一用「点击查看」，锚文本包含关键词：
差：[点击查看详情](./xxx.md)
优：[Markdown静态站图片优化方法](./img-seo.md)
4. 首页聚合所有分类 / 热门文章，给内页传递权重。
五、性能 SEO（静态站天然优势，放大加分）
速度是核心排名因子，MD 静态站只需做好 4 点：
- 图片统一 WebP 压缩，懒加载、响应式尺寸
- 开启服务器 Brotli/Gzip 压缩、HTTP2、HTTPS
- JS/CSS 代码分割、异步加载，删除无用第三方脚本
- 国内部署搭配 CDN（七牛 / 腾讯云 / 阿里云），降低 TTFB
国内 MD 文档站踩坑：Docsify 纯 JS 渲染 SEO 极差
Docsify 默认前端动态渲染，爬虫抓取空白 HTML，解决方案二选一：
- 改用 VitePress/Hugo/Astro（构建输出纯静态 HTML，推荐）
- 开启 SSR 预渲染插件，否则百度收录困难
六、收录提交与站长平台配置
- 域名备案、全站 HTTPS（国内百度硬性要求）
- 百度资源平台：验证站点、提交 sitemap、自动推送（VitePress 可装百度自动推送插件）
- Google Search Console：提交 sitemap、检查索引覆盖、移动端可用性
- Bing 站长平台同步提交地图
- 新站每天手动推送 10–20 篇新文章链接，加速收录
七、主流 MD 建站工具专属 SEO 快速配置
1. VitePress（文档 / 博客首选，SEO 友好）
.vitepress/config.js全局 head 注入 meta、OG、百度推送、sitemap 插件
frontmatter 完整支持 title/description/canonical/ogImage
2. Hugo（速度最快，适合大量 MD）
开启hasCJKLanguage = true支持中文摘要，自动生成 sitemap、RSS
3. Astro（MDX/MD 通用，SSR 可选）
content 集合统一管理文章，自动输出结构化数据、图片优化
4. Hexo（传统博客）
安装 sitemap、baidu-autopush、image 压缩插件
5. Docsify（仅适合内网，公开站不推荐 SEO）
必须预渲染，否则爬虫无法抓取正文
八、高频 SEO 踩坑避坑清单
- ❌ 每篇 MD 共用同一个 description（重复描述降权）
✅ 每篇独立差异化描述 - ❌ URL 带中文、空格、特殊符号
✅ 英文短横线 slug - ❌ 图片不写 alt、原图大图不压缩
- ❌ 缺少 sitemap、robots 文件，爬虫找不到页面
- ❌ 大量无价值分页、标签页不设置 noindex
- ❌ 纯 JS Docsify 不预渲染，百度零收录
- ❌ 外部链接不添加 nofollow，流失站点权重
- ❌ 标题超过 60 字符、描述超过 160 字符，搜索结果截断
九、落地执行流程（从写 MD 到上线全流程）
- 新建 MD 文件，填写完整 Frontmatter TDK、时间、OG、canonical
- 正文规范 H1-H3 层级、图片 alt、自然植入关键词、站内互链
- SSG 构建静态 HTML，开启 sitemap、图片压缩、代码压缩
- 模板注入面包屑、Article 结构化数据、全局 meta 标签
- 根目录上传 robots.txt，CDN 部署全站 HTTPS
- 站长平台验证域名，提交 sitemap，开启自动推送
- 每周新增 MD 文章，持续更新内链、补充长尾内容