# Markovo SEO 关键词库与页面映射

> Audience: Product、Growth、Content、Frontend、SEO QA、Release owner
> Status: Canonical
> Owner: Product / Growth owner
> Last verified: 2026-08-18
> Source of truth: `cloudflare/worker/public/*.html`、`cloudflare/worker/public/sitemap.xml`、`cloudflare/worker/scripts/content-seo-audit.mjs`、`cloudflare/worker/scripts/homepage-on-page-audit.mjs`
> Purpose: 记录已收录阶段的关键词所有权、页面内容合同与防互抢门禁。

## 1. 当前关键词裁决

1. 首页 `/` 唯一承接 `File to Markdown Converter` 品类意图，继续使用已收录根 URL，不迁移到关键词路径。
2. `/pdf-to-markdown` 唯一承接 `PDF to Markdown Converter`，返回独立页面 200、使用自引用 canonical，并进入 Sitemap。
3. `/pdf-to-markdown.html` 只作为历史扩展名 URL，永久 308 到 `/pdf-to-markdown`，不进入 Sitemap。
4. Word、PowerPoint、Excel、CSV、Image、URL、EPUB、Notion、Audio、Video 页面各自承接一个 `X to Markdown Converter` 主词；近义词合并到同一 URL，不按关键词逐词建页。
5. 已收录页面只做关键词落位、事实纠正和机器可读信息同步等小改，不重做布局、交互、组件 ID、视觉系统或 URL。
6. 每个主词必须自然出现在 Title、Description、唯一 H1、首段和至少一个 H2/H3；正文完整短语保持 2–6 次且占位密度低于 3%，不机械堆砌。
7. 页面文案必须与能力事实一致：PDF 为 Available；其余已接通格式为 Signed-in Beta；Video 只转写音轨；Notion 只处理导出包；URL 只处理可公开访问的 HTTPS 页面。
8. 搜索量、KD、访问量和趋势只是研究输入。排期数据必须标明 `market`、`locale`、`source`、`collected_at` 与指标定义，不把跨来源数字相加成市场规模。

本裁决取代 2026-08-12 的旧规则。历史文档保留当时事实，但必须在开头标注已被 2026-08-18 规范取代。

## 2. 首页内容合同

| 元素 | 当前批准表达 | 作用 |
| --- | --- | --- |
| URL | `https://markovo.net/` | 已收录根路径；`File to Markdown Converter` 唯一所有者 |
| Title | `File to Markdown Converter for AI, API & MCP \| Markovo` | 保留已收录 Title，品牌置后 |
| Meta Description | `Use our file to Markdown converter for PDF, DOCX, PPTX, XLSX, images, audio, video, and public URLs. Create clean Markdown via Web, API, CLI, or MCP tools.` | 主词、支持输入和使用方式；155 字符 |
| H1 | `File to Markdown Converter for Clean, Structured Output.` | 直接落入完整主词，同时说明输出价值 |
| 首段 | `Use our file to Markdown converter to turn PDFs, documents, images, speech, and video soundtracks into clean, reviewable Markdown bundles.` | 首 100 词内点题并说明真实输入/输出 |
| 格式目录 | `Convert more file types to Markdown` | 分发到 PDF 和其他格式页 |
| 开发者 H2 | `Use the File to Markdown Converter via Web, API, CLI, or MCP.` | 承接 Web 与开发者使用方式 |
| 核心 FAQ | `Which file types can the File to Markdown Converter handle?` | 回答支持范围并链接独立 PDF 页 |

首页仍可自然提及 PDF，但不再把自己定义为 PDF 转换落地页。Title 保持不变，其余修改仅用于把既有多格式产品事实与主词对齐；上传、结果、价格、API/CLI/MCP 和反馈板块结构保持不变。

## 3. PDF 页面内容合同

| 元素 | 当前批准表达 | 作用 |
| --- | --- | --- |
| URL | `https://markovo.net/pdf-to-markdown` | 独立可索引、自引用 canonical |
| Title | `PDF to Markdown Converter with API, CLI & MCP \| Markovo` | 明确主词和程序化入口 |
| Meta Description | `Convert PDF to Markdown with headings, tables, images, source maps, and quality evidence. Try it online or use Markovo through API, CLI, and MCP securely.` | 说明输出结构、证据和使用方式；154 字符 |
| H1 | `PDF to Markdown Converter for Clean, Reviewable Output.` | 完整主词和可复核价值 |
| 首段 | `Use the PDF to Markdown Converter to preserve headings, tables, images, formulas, and page-linked evidence in a clean Markdown bundle.` | 首 100 词点题并描述 PDF 专属结果 |
| 页面任务 | PDF 上传、扫描件/OCR、表格、公式、Bundle、API/CLI/MCP、AI/RAG/编辑与 FAQ | 与首页品类任务区分，避免重复薄页 |

PDF 页面保留真实转换交互和现有组件 ID。文案不承诺完美 OCR、完美布局还原或无需复核；扫描件、复杂表格和公式结果明确建议人工检查。

## 4. 页面所有权矩阵

| URL | 唯一主关键词 | 当前 H1 | 重要变体 | Sitemap |
| --- | --- | --- | --- | --- |
| `/` | `File to Markdown Converter` | `File to Markdown Converter for Clean, Structured Output.` | `file to Markdown`、`convert files to Markdown` | 是 |
| `/pdf-to-markdown` | `PDF to Markdown Converter` | `PDF to Markdown Converter for Clean, Reviewable Output.` | `PDF to Markdown`、`convert PDF to Markdown`、`PDF to MD` | 是 |
| `/word-to-markdown` | `Word to Markdown Converter` | `Word to Markdown Converter for Structured Documents.` | `DOCX to Markdown`、`Word to MD` | 是 |
| `/powerpoint-to-markdown` | `PowerPoint to Markdown Converter` | `PowerPoint to Markdown Converter in Slide Order.` | `PPTX to Markdown` | 是 |
| `/excel-to-markdown` | `Excel to Markdown Converter` | `Excel to Markdown Converter for Clean XLSX Tables.` | `XLSX to Markdown` | 是 |
| `/csv-to-markdown` | `CSV to Markdown Converter` | `CSV to Markdown Converter for Clean Tables.` | `CSV to Markdown table` | 是 |
| `/image-to-markdown` | `Image to Markdown Converter` | `Image to Markdown Converter with Reviewable OCR.` | `image OCR to Markdown` | 是 |
| `/url-to-markdown` | `URL to Markdown Converter` | `URL to Markdown Converter for One Public Page.` | `webpage to Markdown` | 是 |
| `/epub-to-markdown` | `EPUB to Markdown Converter` | `EPUB to Markdown Converter with Chapters and Assets.` | `ebook to Markdown` | 是 |
| `/notion-to-markdown` | `Notion Export to Markdown Converter` | `Notion Export to Markdown Converter without an Account Connector.` | `Notion to Markdown` | 是 |
| `/audio-to-markdown` | `Audio to Markdown Converter` | `Audio to Markdown Converter with Reviewable Timestamps.` | `audio transcription to Markdown` | 是 |
| `/video-to-markdown` | `Video to Markdown Converter` | `Video to Markdown Converter from the Audio Track.` | `video transcript to Markdown` | 是 |

格式页最低合同：主词出现在 Title、Description、唯一 H1、首 120 词和至少一个 H2/H3；正文至少 500 个可见英文词，包含真实输入、输出、限制、访问状态、使用场景、FAQ 和转化动作。首页至少 1,100 词，PDF 页至少 1,000 词。

## 5. canonical、内链与 Sitemap

- 每个可索引页面 canonical 指向自身无扩展名 URL；首页固定为 `https://markovo.net/`。
- Sitemap 包含首页、PDF 页和其余十个格式页，不包含任何 `.html` URL 或重定向 URL。
- 首页格式目录直接链接全部十一种格式页，PDF 页与格式页使用描述性锚文本回链首页或相关使用入口。
- `/docs` 与 `/pricing` 承接文档、API、CLI、MCP、价格和商业决策，不与工具页争夺转换主词。
- 新格式页必须先有真实能力、独有内容任务、边界、示例和转化链路；关键词存在本身不是建页理由。

## 6. 统一 On Page SEO 体检范式

每个关键词页面使用同一套检查，不因格式不同而降低要求：

1. **页面归属**：一个主词对应一个可索引 canonical；不得与首页或其他格式页互抢。
2. **Meta**：Title 建议 15–60 字符，Description 建议 70–160 字符；OG 和 Twitter 与页面 Title/Description 同步。
3. **正文落位**：完整主词进入唯一 H1、首段和至少一个 H2/H3；自然重复 2–6 次，占位密度低于 3%。
4. **内容任务**：说明格式专属输入、输出结构、典型场景、限制、访问状态、API/CLI/MCP 或 Web 使用方式、FAQ 与下一步。
5. **真实性**：不得把 Beta 写成 Available，不得把音轨转写写成画面理解，不得暗示账户连接、受保护网页抓取或完美 OCR。
6. **技术 SEO**：200、HTTPS、自引用 canonical、可索引 robots、Sitemap、服务端直出、唯一 H1、结构化数据、社交元信息和安全外链。
7. **体验保护**：已收录页面优先小改；不为了密度重排大段布局，不更换稳定 URL，不删除真实任务交互。

## 7. 自动审计与发布验收

运行入口：

```bash
cd cloudflare/worker
npm run audit:content-seo
npm run audit:seo
npm test
npm run typecheck
```

自动审计必须覆盖十二个关键词页，并检查：

- 唯一 URL、canonical、Sitemap 和首页内链；
- Title、Description、H1、首段、H2/H3、短语次数、占位密度和最低正文词数；
- OG/Twitter 与 Meta 同步；
- SoftwareApplication、FAQPage 与可见 FAQ 一致；
- `/pdf-to-markdown` 返回 200，`/pdf-to-markdown.html` 308 到无扩展名规范 URL；
- 首页与 PDF 页主词不重复，所有页面的能力边界真实。

首页逐项报告继续由 `homepage-on-page-audit.mjs` 输出，但目标词改为 `file to markdown converter`。静态审计只证明仓库资产；生产发布后还必须复核正式域名状态码、canonical、robots、Sitemap、结构化数据、可见正文和无 `noindex`。

## 8. 数据与监控回路

历史关键词数据仍由 [`关键词梳理`](../../关键词梳理/README.md) 管理。上线后按页面和查询簇在 14/28 天观察：

1. Search Console impressions、clicks、CTR、average position 与索引状态；
2. 首页和 PDF 页是否出现查询互抢或 canonical 异常；
3. 上传、登录、估价、确认、完成、下载和格式页到交付的漏斗；
4. 新查询应归并到现有 URL，还是具备独立搜索意图与真实产品任务；
5. 低 CTR 优先检查 Title/Description 与意图，点击无转化优先检查任务、能力边界和结果证明。

回退以最小字符串级回滚为主。若 PDF 页发生 5xx、错误 canonical/noindex 或严重重复内容，先修复页面；只有页面无法安全提供服务时，才临时把 `/pdf-to-markdown` 308 到首页，并同步 Sitemap、文档和事故记录。