H1标签必须唯一且位于页面最前，内容与页面主题强相关，与title语义一致，禁止用作样式工具，确保HTML语义纯净。

一个页面只放一个

，且必须出现在

内部最靠前的位置

，这是当前 Google 移动优先索引识别核心主题的硬性规则。

确保

语义唯一且位置正确

搜索引擎把

当作“这本书的书名”，不是加粗工具。它需要明确知道：这个 URL 对应的页面，到底在讲什么。

• 必须落在

  标签内，且是

  中第一个有意义的子元素（不能是空 div 或占位符）

• 内容要与当前页面强相关，比如文章页用

  React 19 中 useActionState 的实际陷阱

  ，订单页用

  订单确认：#ORD-78291

• 避免在
  或全局布局里硬编码

  网站名，再于正文又写一个——这是最常见的重复根源

让

和

搭配

如何用 Web Vitals 诊断并修复 LCP 延迟

是合理匹配；若

写成“团队介绍”就属于语义断裂

Next.js 用户须用generateMetadata同步生成

避开常见技术陷阱

动态页面中

Convert Markdown To HTML And PDF - Markdown和HTML、PDF互转

实现 Markdown↔ HTML 互转，支持导出 PDF，用于用户请求的文档格式转换。

下载

容易因渲染时机或模板逻辑出错，但问题隐蔽、无报错提示。

• Vue/React SPA：不要在根容器（如
  ）上预设

  ；每个路由组件应在

  下独立渲染

  ，并确保切换时旧节点被卸载

  WordPress 主题：检查 single.php 是否在

  写了

  ，应删除，改用

  放在主内容区

  静态页或 CMS 输出后，可用document.querySelectorAll('h1').length快速验证是否为 1；若为 0 或 ≥2，需回溯模板或 SSR 配置

  不把

  当样式工具用

  视觉效果全部交给 CSS 控制。任何在标签内写 style、align、font-size 的做法，都会破坏语义一致性。

  • 禁止用 display: none 隐藏

    再用伪元素“视觉还原”——辅助技术完全无法感知

  • 如果 CMS 不可控，宁可用 JS 动态移除多余

    ，也不要妥协语义

  • 所有字号、颜色、间距等，统一通过 class + CSS 实现，保持 HTML 干净可读