Fix remaining AFDocs checks: HTML/MD parity, llms.txt coverage, and discoverability directives (#2929)

* llms: regenerate markdown, inject directives

Add turndown + gfm dependencies and enhance llms-html-injector to derive per-page .md files from rendered HTML (cheerio + turndown), prepend llms.txt directive to .md files, inject <link rel="alternate" type="text/markdown"> into HTML heads and an sr-only body directive, prune stale links from llms-*.txt, and generate llms-all-*.txt indexes from sitemap.xml. Also mark various DocItem UI chrome with data-markdown-ignore so HTML→MD parity ignores UI-only elements, and update static/llms.txt to reference the new complete indexes. package.json and package-lock.json updated to include the new dependencies.

* Replace turndown with node-html-markdown

Swap turndown/turndown-plugin-gfm for node-html-markdown and update llms HTML->MD pipeline. package.json/package-lock: add node-html-markdown and remove turndown deps. src/plugins/llms-html-injector: replace TurndownService with NodeHtmlMarkdown, add custom translators/options to preserve <details>/<summary> and narrow escaping for parity, change injected markdown alt link to use path-only hrefs, and add Vercel preview detection + host-rewrite logic to rewrite production URLs to the preview origin for llms*.txt and per-page .md files. src/theme/DocItem/Layout/index.jsx: change data-markdown-ignore wrapper from <span> to <div> around CopyPageButton so it is stripped correctly during MD generation.

* Prefer VERCEL_BRANCH_URL for previews

Add cheerio dependency and update preview URL handling for Vercel deployments.

resolvePreviewSiteUrl now prefers VERCEL_BRANCH_URL and falls back to VERCEL_URL, with expanded JSDoc explaining Vercel env vars and rationale. postProcessLlmsOutput logs which env var was used and rewrites build artifacts to point at the preview host so AFDocs checks (llms txt/markdown link checks) work correctly on branch/preview/development deployments.

* Regenerate MD, mark KaTeX, add Vercel header

Regenerate per-page .md files from their rendered HTML and mark KaTeX MathML spans to improve HTML/Markdown parity. Renamed and expanded the HTML->MD flow (regenerateMdFromHtml): walk build/**/index.html, convert article content to markdown, create missing .md siblings, and report regenerated/created/skipped counts. Add a regex and injection step to mark <span class="katex-mathml"> with data-markdown-ignore (idempotent) and log how many spans were marked. Improve katex handling in htmlToMarkdown by extracting the visual .katex-html text into a <code> node to avoid duplicated math content and by flattening Docusaurus chrome inside <details> so NHM output matches the rendered HTML. Tweak node-html-markdown options/translators (details/summary handling and line-start escaping) and update injector return values and logging. Also add a Vercel route header to serve llms*.txt as text/markdown with utf-8 charset.

* Route root to /llms.txt and add headers

Rewrite requests for the site root to /llms.txt in middleware because the homepage has no .md sibling (the root index.html is skipped by the llms-html-injector), ensuring the documentation index is served as text/markdown. Add a Content-Signal line to static/robots.txt to advertise search/AI allowances (search=yes, ai-input=yes, ai-train=yes). Add a Link header for "/" in vercel.json pointing to </llms.txt> as rel="service-doc" and rel="alternate"; type="text/markdown" so clients can discover the markdown service doc.

* Use internal MetaMask provider link in EVM docs

Replace external MetaMask Provider URL with the internal /metamask-connect/evm/reference/provider-api/ link across many embedded-wallets EVM React Native docs. Also include minor updates to SDK docs, plugins, example maps, static images/logos and vercel.json to keep assets and tooling in sync.

* Make /quickstart route canonical, remove splat

Register the plugin-provided /quickstart route as the single canonical page and prevent the pages plugin from auto-generating a duplicate module-less route. Exclude quickstart/index.jsx in docusaurus.config.js and remove the `${routePath}/*` splat route in the virtual-files plugin; navigation uses query strings so no catch-all child route is needed and the splat produced malformed `/quickstart/*/` sitemap entries.

* Update Algolia indexName to project name

Change the Algolia indexName in docusaurus.config.js from 'mmdocs' to 'MetaMask Documentation' to reflect the project's full name in search configuration. Verify that the corresponding Algolia index exists and that the provided appId/apiKey remain valid after this change.

* Normalize sitemap before reading URLs

Move normalizeSitemap earlier in postProcessLlmsOutput so the sitemap is normalized (dropping <loc> entries shadowed by vercel.json redirects and stripping trailing slashes from dotted-segment routes) before readSitemapUrls, pruneStaleLlmsLinks, and generateAllPagesIndex run. This ensures generated llms-all-*.txt indexes and pruning operate on the same 200-only URL set the deployed sitemap exposes and avoids pointing agents at redirecting pages. Add console logging for skipped or processed sitemap normalization.

Author: shahbaz17

docusaurus.config.js

@@ -208,6 +208,14 @@ const config = {
             'quickstart/MediaStep/**',
             'quickstart/interfaces.ts',
             'quickstart/utils.tsx',
+            // The `/quickstart` route is registered by the
+            // `docusaurus-plugin-virtual-files` plugin, which also injects the
+            // `files` route module the page reads. Letting the pages plugin
+            // auto-generate a route for `index.jsx` produced a second,
+            // module-less `/quickstart` route and a duplicate `/quickstart/`
+            // entry in the sitemap. Exclude it here so the plugin route is the
+            // single canonical one.
+            'quickstart/index.jsx',
           ],
           mdxPageComponent: '@theme/MDXPage',
           remarkPlugins,
@@ -655,7 +663,7 @@ const config = {
         // The application ID provided by Algolia
         appId: 'W4ZOZ72ZFG',
         apiKey: 'b4e925aa9bf05e5bef2e40b3ee6ee431',
-        indexName: 'mmdocs',
+        indexName: 'MetaMask Documentation',
         contextualSearch: false,
         translations: {
           button: {

embedded-wallets/connect-blockchain/evm/aleph-zero/react-native.mdx

@@ -10,7 +10,7 @@ description: 'Integrate Embedded Wallets with the Aleph Zero Blockchain in React
 import EVMInteraction from '../../_react-native-connect-blockchain/_evm-interaction.mdx'
 import ChainDetailsAlephZero from '../../_general-connect-blockchain/_aleph-zero.mdx'
 
-While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](https://docs.metamask.io/guide/ethereum-provider.html). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Aleph Zero](https://ethereum.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
+While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](/metamask-connect/evm/reference/provider-api/). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Aleph Zero](https://ethereum.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
 
 ## Chain details for Aleph Zero
 

embedded-wallets/connect-blockchain/evm/ancient8/react-native.mdx

@@ -10,7 +10,7 @@ description: 'Integrate Embedded Wallets with the Ancient8 Blockchain in React N
 import EVMInteraction from '../../_react-native-connect-blockchain/_evm-interaction.mdx'
 import ChainDetailsAncient8 from '../../_general-connect-blockchain/_ancient8.mdx'
 
-While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](https://docs.metamask.io/guide/ethereum-provider.html). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Ancient8](https://ethereum.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
+While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](/metamask-connect/evm/reference/provider-api/). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Ancient8](https://ethereum.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
 
 ## Chain details for Ancient8
 

embedded-wallets/connect-blockchain/evm/arbitrum/react-native.mdx

@@ -10,7 +10,7 @@ description: 'Integrate Embedded Wallets with the Arbitrum Blockchain in React N
 import EVMInteraction from '../../_react-native-connect-blockchain/_evm-interaction.mdx'
 import ChainDetailsArbitrum from '../../_general-connect-blockchain/_arbitrum.mdx'
 
-While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](https://docs.metamask.io/guide/ethereum-provider.html). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Arbitrum](https://arbitrum.io/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
+While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](/metamask-connect/evm/reference/provider-api/). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Arbitrum](https://arbitrum.io/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
 
 ## Chain details for Arbitrum
 

embedded-wallets/connect-blockchain/evm/astar-zkevm/react-native.mdx

@@ -10,7 +10,7 @@ description: 'Integrate Embedded Wallets with the Astar zkEVM Blockchain in Reac
 import EVMInteraction from '../../_react-native-connect-blockchain/_evm-interaction.mdx'
 import ChainDetailsAstarZkevm from '../../_general-connect-blockchain/_astar-zkevm.mdx'
 
-While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](https://docs.metamask.io/guide/ethereum-provider.html). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Astar zkEVM](https://ethereum.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started quickly.
+While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](/metamask-connect/evm/reference/provider-api/). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Astar zkEVM](https://ethereum.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started quickly.
 
 ## Chain details for Astar zkEVM
 

embedded-wallets/connect-blockchain/evm/astar-zkyoto/react-native.mdx

@@ -10,7 +10,7 @@ description: 'Integrate Embedded Wallets with the Astar Zkyoto Blockchain in Rea
 import EVMInteraction from '../../_react-native-connect-blockchain/_evm-interaction.mdx'
 import ChainDetailsAstarZkyoto from '../../_general-connect-blockchain/_astar-zkyoto.mdx'
 
-While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](https://docs.metamask.io/guide/ethereum-provider.html). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Astar Zkyoto](https://ethereum.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
+While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](/metamask-connect/evm/reference/provider-api/). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Astar Zkyoto](https://ethereum.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
 
 ## Chain details for Astar Zkyoto
 

embedded-wallets/connect-blockchain/evm/avalanche/react-native.mdx

@@ -10,7 +10,7 @@ description: 'Integrate Embedded Wallets with the Avalanche Blockchain in React
 import EVMInteraction from '../../_react-native-connect-blockchain/_evm-interaction.mdx'
 import ChainDetailsAvalanche from '../../_general-connect-blockchain/_avalanche.mdx'
 
-While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](https://docs.metamask.io/guide/ethereum-provider.html). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Avalanche](https://www.avax.network/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
+While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](/metamask-connect/evm/reference/provider-api/). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Avalanche](https://www.avax.network/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
 
 ## Chain details for Avalanche
 

embedded-wallets/connect-blockchain/evm/base/react-native.mdx

@@ -10,7 +10,7 @@ description: 'Integrate Embedded Wallets with the Base Blockchain in React Nativ
 import EVMInteraction from '../../_react-native-connect-blockchain/_evm-interaction.mdx'
 import ChainDetailsBase from '../../_general-connect-blockchain/_base.mdx'
 
-While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](https://docs.metamask.io/guide/ethereum-provider.html). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Base](https://base.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
+While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](/metamask-connect/evm/reference/provider-api/). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Base](https://base.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
 
 ## Chain details for Base
 

embedded-wallets/connect-blockchain/evm/bitkub/react-native.mdx

@@ -10,7 +10,7 @@ description: 'Integrate Embedded Wallets with the Bitkub Blockchain in React Nat
 import EVMInteraction from '../../_react-native-connect-blockchain/_evm-interaction.mdx'
 import ChainDetailsBitkub from '../../_general-connect-blockchain/_bitkub.mdx'
 
-While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](https://docs.metamask.io/guide/ethereum-provider.html). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Bitkub](https://ethereum.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
+While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](/metamask-connect/evm/reference/provider-api/). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [Bitkub](https://ethereum.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
 
 ## Chain details for Bitkub
 

embedded-wallets/connect-blockchain/evm/bnb/react-native.mdx

@@ -10,7 +10,7 @@ description: 'Integrate Embedded Wallets with the BNB Blockchain in React Native
 import EVMInteraction from '../../_react-native-connect-blockchain/_evm-interaction.mdx'
 import ChainDetailsBnb from '../../_general-connect-blockchain/_bnb.mdx'
 
-While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](https://docs.metamask.io/guide/ethereum-provider.html). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [BNB](https://www.bnbchain.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
+While using the Web3Auth React Native SDK, you get a [`EIP1193`](https://eips.ethereum.org/EIPS/eip-1193) provider, similar to the [MetaMask Provider](/metamask-connect/evm/reference/provider-api/). This provider can be used with libraries like [`web3.js`](https://docs.web3js.org/), [`ethers.js`](https://docs.ethers.io/v5/getting-started/) etc. to make [BNB](https://www.bnbchain.org/) blockchain calls like getting the user's `account`, fetching `balance`, `sign transaction`, `send transaction`, `read` from and `write` to the smart contract, etc. We have highlighted a few here to get you started.
 
 ## Chain details for BNB