Function main

packages/dev/s2-docs/scripts/generateMarkdownDocs.mjs:3762–3873

* Scans the MDX pages in packages/dev/s2-docs/pages and produces a text-based markdown variant of * each file. React-specific JSX elements such as and are replaced * with plain markdown equivalents so that the resulting *.md files can be consumed by LLMs.

()

 * with plain markdown equivalents so that the resulting *.md files can be consumed by LLMs.
 */
async function main() {
  const mdxFiles = (
    await glob('*/**/*.mdx', {
      cwd: S2_DOCS_PAGES_ROOT,
      absolute: true
    })
  ).sort((a, b) => a.localeCompare(b));

  // Collect generated markdown filenames and headings for each library so we can build llms.txt files.
  const docsByLibrary = {
    s2: [],
    'react-aria': [],
    internationalized: [],
    root: []
  };

  for (const filePath of mdxFiles) {
    const rawContent = fs.readFileSync(filePath, 'utf8');

    // Skip redirect pages
    if (rawContent.includes('<meta http-equiv="refresh"')) {
      continue;
    }

    // Skip error pages
    if (path.basename(filePath) === 'error.mdx') {
      continue;
    }

    let mdContent = rawContent.replace(LICENSE_COMMENT_REGEX, '');

    // Inline the S2 Routers MDX content once at the bottom of the page.
    // Avoids rendering the same content for every framework.
    if (mdContent.includes('<Routers components={props.components} />')) {
      mdContent = mdContent.replace(ROUTERS_PLACEHOLDER_REGEX, 'See the Routers section below.');
      mdContent += '\n\n## Routers\n\n' + getRoutersMdxContent();
    }

    const processor = unified()
      .use(remarkParse)
      .use(remarkMdx)
      .use(remarkRemoveImportsExports)
      .use(remarkDocsComponentsToMarkdown);

    const file = {value: mdContent, path: filePath};
    const tree = processor.parse(file);
    const transformed = await processor.run(tree, file);
    let markdown = toMarkdown(transformed, {
      fences: true,
      bullet: '-',
      listItemIndent: 'one',
      extensions: mdxToMarkdown.extensions
    });

    // Convert markdown links ending in .html to .md (relative links only)
    markdown = markdown.replace(/\[([^\]]+)\]\(([^)]+\.html)\)/g, (match, text, url) => {
      if (!url.startsWith('http') && !url.startsWith('//')) {
        return `[${text}](${url.replace(/\.html$/, '.md')})`;