最可靠方式是用``嵌入JSON-LD，type必须为"application/ld+json"且放<head>中；Article需含headline、datePublished（ISO 8601）、author（对象格式）；动态页面须服务端注入；多实体需分script或用数组包裹。

Wechat HTML Publisher

直接上传HTML富文本到微信公众号草稿箱。支持完整的HTML格式,无需Markdown转换。

下载

直接用 `<script type="application/ld+json">` 嵌入 JSON-LD 是当前最可靠、Google 明确推荐的方式。Microdata 和 RDFa 容易因 HTML 结构变动或 JS 渲染时机失效，除非有遗留系统兼容需求，否则别碰。 <h3>为什么必须用 <code>type="application/ld+json" <p>Google 不解析 <code>text/json、<code>application/json 或没写 <code>type 的 script 标签；也不保证能抓到被 JS 动态插入的块。它只认 <code>type="application/ld+json"，且内容必须是纯 JSON（不是 JS 对象字面量）。 <ul> <li>错误写法：<code><script>{ name: "test" }</script>（缺 type，键没双引号） <li>错误写法：<code><script type="text/json">{"name":"test"}</script>（type 错） <li>正确位置：放在 <code><head> 里最稳；放 <code><body> 顶部也行，但别塞在其他 <code><script> 内部或注释里 <h3><code>Article 类型填不全字段就白加 <p>Google 要求 <code>Article 至少含 <code>headline、<code>datePublished、<code>author 三个字段，漏一个整段标记就被忽略。 <ul> <li><code>datePublished 必须是 ISO 8601 格式，如 <code>"2024-05-20" 或 <code>"2024-05-20T14:30:00+08:00"；写成 <code>"2024/05/20" 或 <code>"2024年5月20日" 会失败 <li><code>author 不能只写字符串 <code>"张三"，得是对象：<code>{"@type": "Person", "name": "张三"}；如果是机构，<code>@type 得设为 <code>"Organization" <li><code>image 字段值必须是可公开访问的 HTTPS URL，相对路径（如 <code>"./img.jpg"）或本地路径（如 <code>"C:\img.jpg"）全无效 <h3>动态页面（React/Vue/Next.js）最容易踩的坑 <p>结构化数据必须随首屏 HTML 一起下发。在 <code>useEffect、<code>mounted 或 <code>document.createElement('script') 里注入，爬虫根本看不到。 <ul> <li>SSR 框架（如 Next.js）：用 <code>next/head 或 <code>useHead 在服务端注入，确保 script 出现在初始 HTML 中 <li>模板引擎（如 PHP、Nunjucks）：用 <code>json_encode() 或对应语言的安全序列化函数输出 JSON，别手拼字符串——标题含 <code>" 或 <code>\n 会直接破坏 JSON 结构 <li>测试前先关掉广告屏蔽插件，它们可能过滤掉 <code><script type="application/ld+json"> 标签 <h3>验证时别信编辑器高亮，只信 Google 工具 <p>语法合法 ≠ Google 认可。JSON 格式对、<code>@type 对、字段也填了，但 URL 不可访问、时间格式少个 <code>T、<code>@id 没写绝对地址——这些细节错一点，Search Console 就报 “无效”。<p><span>立即学习“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记（深入）”； <ul> <li>上线前：把完整 HTML 源码（含 script 块）粘贴进 <a href="https://www.php.cn/link/937e55950b2f7c61e80237f72dafc94b" target="_blank">URL Inspection Tool → “测试实时 URL” → 展开 “富媒体搜索结果” <li>本地调试：用 <a href="https://www.php.cn/link/937e55950b2f7c61e80237f72dafc94b" target="_blank">Rich Results Test（已整合进上一工具），拖入 HTML 文件或粘贴源码，它会标出缺失字段和格式错误位置 <li>多实体共存时：要么每个 <code><script> 只放一个对象，要么明确用数组包住：<code>[{"@type":"Article",...},{"@type":"Organization",...}]；混着写（一个对象里塞两个 <code>@type）会被当语法错误 实际部署时，最常被忽略的是：服务端模板未做 JSON 转义、图片 URL 返回 404、面包屑的 <code>position 从 0 开始或跳号、以及把 <code>BreadcrumbList 错写成 <code>Breadcrumb —— 这些问题不会报错，但标记直接失效。</script>