用途：这是一份 WordPress 区块（Block）标记语法参考，用于编写 pattern、模板或 REST API 内容推送所需的原始区块标记，排查区块验证错误（如“Block contains unexpected content”），把 HTML 程序化转换为区块格式，在 PHP 中处理区块模板，以及理解区块如何序列化进 post_content。
主要能力：
- 区块语法。区块用 HTML 注释作分隔符，注释之间为合法 HTML。三种形式：成对区块（开+闭）、自闭合/空区块（无内部 HTML）、带属性的成对区块。命名上核心区块省略命名空间（如 wp:paragraph），不可写 core/ 前缀，自定义区块必须带命名空间（如 wp:acf/callout）。
- 属性序列化。属性存两处：注释 JSON 存无法从 HTML 推导的值（ID、布尔、枚举、样式对象、布局配置）；HTML 内容存来自 DOM 的值（文本、src、href、alt、CSS 类）。由 block.json 的 source 属性决定（无 source→注释 JSON；attribute→元素属性；html→innerHTML；text→textContent）。JSON 规则：合法对象、双引号、无尾逗号、紧凑格式、省略默认值、顺序无关、必须单行。
- 常见属性模式。包括调色板预设颜色、自定义十六进制颜色、排版（自定义与预设字号）、间距、边框、布局（constrained/flex）、对齐（full/wide/textAlign）。
- 区块参考。资料逐一给出段落、标题、列表与列表项、图片、表格、按钮与按钮组、组、栏与栏容器、引用、封面、嵌入、分隔线、间隔、代码、预格式化、引文、详情、原始 HTML、视频、音频、画廊、媒体与文本等区块的标记写法与关键规则，例如列表项自 WordPress 6.1 起必须用 wp:list-item 包裹，否则编辑器会显示为单个经典区块或触发区块恢复。
适用场景：主题与插件开发、区块模板与 pattern 制作、内容迁移与批量写入、编辑器报错调试。
限制：资料仅为语法与结构参考，未提供安装命令、收费、价格、平台与效果信息，这些内容暂未提供。