html文档应以语义化结构优先：单个明确主题，合理使用等标签， viewport元标签必写且准确，避免过度嵌套。
HTML文档的逻辑组织不是“怎么好看怎么写”，而是让浏览器、爬虫和开发者三方都能一眼看懂谁是主干、谁是枝叶、谁该被优先索引。
每个页面只用一个 <h1></h1>，且必须包裹核心主题词
搜索引擎把 <h1></h1> 当作页面内容的“身份证”。出现两个或以上 <h1></h1>，等于给爬虫发了冲突指令；空着或塞一堆无关词（比如“欢迎光临”“首页”），等于没填身份证号。
- 首页的
<h1></h1>应为品牌名 + 主业务关键词，例如<h1>北京前端开发工作室</h1> - 文章页的
<h1></h1>必须与<title></title>高度一致，且包含用户真实搜索词，如<h1>HTML文档逻辑组织与SEO关系详解</h1> - 别用
<h1></h1>做视觉放大——CSS 控制字号，语义归语义
<main></main> 里禁用 <div> 堆砌，优先用 <code><section></section> 和 <article></article>
纯 <div> 不带任何语义，爬虫看到一堆 <code><div class="block"> 就得靠猜。而 <code><section></section> 表示一个有标题的主题块，<article></article> 表示可独立分发的内容单元（比如一篇博客、一条新闻）。
-
<section></section>必须配<h2></h2>或更高级别标题，否则它只是个空壳 - 多个同类内容项（如产品列表）用
<article></article>包裹每条，比用<div> + class 更利于结构化数据提取 <li>别在 <code><main></main>外写<section></section>—— 它语义上属于主体内容，放<header></header>或<footer></footer>里会误导爬虫 -
<nav></nav>内只放跳转到其他页面的<a></a>，不放搜索框、登录按钮这类交互控件 -
<aside></aside>不能替代<section></section>：如果侧边栏内容和主内容强相关（比如“本文配套代码下载”），它其实属于主内容延伸，应放进<main></main>的某个<section></section>里 - 移动端折叠导航时，仍要保留
<nav></nav>标签结构，仅用 CSS 隐藏，不要用 JS 动态删掉标签 - 必须写成
<meta name="viewport" content="width=device-width, initial-scale=1">，少一个字符（比如漏掉引号或写成device_width）都可能失效 - 不能用相对路径或 JS 注入——它必须在 HTML 解析早期就存在，所以只能放在
顶部 - 别加
user-scalable=no：这会破坏可访问性，Google 明确表示反感此类限制
<nav></nav> 和 <aside></aside> 的边界必须清晰
<nav></nav> 是全站导航路径，<aside></aside> 是当前内容的补充信息（如相关链接、作者简介、广告）。混用会导致爬虫误判页面重点。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
<meta name="viewport"> 缺失或写错，直接让移动端 SEO 归零
这不是“锦上添花”的配置，而是 Google 移动端索引的硬性门槛。没有它，页面在手机端缩放异常，爬虫会判定为“不支持移动设备”，降权几乎不可避免。
最容易被忽略的其实是层级嵌套的“深度控制”：比如 <article></article> 里再套三层 <section></section>，或者 <header></header> 里塞进整个导航菜单加搜索加登录栏。结构越深，爬虫解析成本越高，关键内容权重反而被稀释。保持扁平、明确、各司其职，比堆砌新标签更重要。
