Function renderMarkdown

server/utils/docs/text.ts:102–143

(text: string, symbolLookup: SymbolLookup)

 * @internal Exported for testing
 */
export async function renderMarkdown(text: string, symbolLookup: SymbolLookup): Promise<string> {
  // Extract fenced code blocks FIRST (before any HTML escaping)
  // Pattern handles:
  // - Optional whitespace before/after language identifier
  // - \r\n, \n, or \r line endings
  const codeBlockData: Array<{ lang: string; code: string }> = []
  let result = text.replace(
    /```[ \t]*(\w*)[ \t]*(?:\r\n|\r|\n)([\s\S]*?)(?:\r\n|\r|\n)?```/g,
    (_, lang, code) => {
      const index = codeBlockData.length
      codeBlockData.push({ lang: lang || 'text', code: code.trim() })
      return `__CODE_BLOCK_${index}__`
    },
  )

  // Now process the rest (JSDoc links, HTML escaping, etc.)
  result = parseJsDocLinks(result, symbolLookup)

  // Markdown links - i.e. [text](url)
  result = result.replace(
    /\[([^\]]+)\]\((https?:\/\/[^)]+)\)/g,
    '<a href="$2" target="_blank" rel="noreferrer" class="docs-link">$1</a>',
  )

  // Handle inline code (single backticks) - won't interfere with fenced blocks
  result = result
    .replace(/`([^`]+)`/g, '<code class="docs-inline-code">$1</code>')
    .replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>')
    .replace(/\n{2,}/g, '<br><br>')
    .replace(/\n/g, '<br>')

  // Highlight and restore code blocks
  const highlightedCodeBlocks = await Promise.all(
    codeBlockData.map(({ lang, code }) => highlightCodeBlock(code, lang)),
  )

  highlightedCodeBlocks.forEach((highlighted, i) => {
    result = result.replace(`__CODE_BLOCK_${i}__`, () => highlighted)
  })

  return result
}