@@ -307,4 +307,42 @@ var a = 1
     expect(alertEl.hasClass('ghd-alert-accent')).toBe(true)
     expect(alertEl.find('a[href="https://example.com"]').length).toBe(1)
   })
+
+  describe('markdownRequested output', () => {
+    const markdownContext = {
+      markdownRequested: true,
+      currentLanguage: 'en',
+      currentVersion: 'free-pro-team@latest',
+      pages: {},
+      redirects: {},
+    }
+
+    test('keeps alert markers unescaped when rewriting internal links', async () => {
+      const template = nl(`> [!NOTE]
+> See [Billing](/billing/foo).
+
+> [!WARNING]
+> Careful.`)
+      const markdown = await renderContent(template, markdownContext)
+      expect(markdown).toContain('> [!NOTE]')
+      expect(markdown).toContain('> [!WARNING]')
+      expect(markdown).not.toContain('\\[!')
+      expect(markdown).toContain('(/en/billing/foo)')
+    })
+
+    test('keeps escaping alert-like text outside the start of a blockquote', async () => {
+      const template = 'Type \\[!NOTE] to start an alert. See [Billing](/billing/foo).'
+      const markdown = await renderContent(template, markdownContext)
+      expect(markdown).toContain('Type \\[!NOTE] to start an alert.')
+      expect(markdown).toContain('(/en/billing/foo)')
+    })
+
+    test('keeps an escaped alert marker escaped at the start of a blockquote', async () => {
+      const template = nl(`> \\[!NOTE]
+> See [Billing](/billing/foo).`)
+      const markdown = await renderContent(template, markdownContext)
+      expect(markdown).toContain('> \\[!NOTE]')
+      expect(markdown).toContain('(/en/billing/foo)')
+    })
+  })
 })
@@ -32,6 +32,9 @@ import annotate from './annotate'
 import alerts from './alerts'
 import removeHtmlComments from 'remark-remove-comments'
 import remarkStringify from 'remark-stringify'
+import { visit } from 'unist-util-visit'
+import type { Parents, Root, Text } from 'mdast'
+import type { Info, State } from 'mdast-util-to-markdown'
 import type { Context, UnifiedProcessor } from '@/content-render/types'
 import type { CollectedHeading } from '@/frame/lib/get-mini-toc-items'
 
@@ -84,12 +87,49 @@ export function createMarkdownOnlyProcessor(context: Context): UnifiedProcessor
     unified()
       .use(remarkParse)
       .use(gfm)
+      .use(markUnescapedAlertMarkers)
       // TypeScript's unified plugin types do not model context-bound transformer factories.
       .use(rewriteLocalLinks as unknown as (ctx: Context) => void, context)
-      .use(remarkStringify) as unknown as UnifiedProcessor
+      .use(remarkStringify, {
+        handlers: { text: textWithAlertMarkers },
+      }) as unknown as UnifiedProcessor
   )
 }
 
+// GitHub alert markers stop rendering as alerts once remark-stringify escapes their brackets.
+const ALERT_MARKER = /^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\](?=\s|$)/i
+
+// remark-parse drops the backslash from `\[!NOTE]`, so only the source shows an intentionally literal marker.
+const unescapedAlertMarkers = new WeakSet<Text>()
+
+function markUnescapedAlertMarkers() {
+  return (tree: Root, file: { value: unknown }) => {
+    const source = String(file.value)
+    visit(tree, 'text', (node) => {
+      const offset = node.position?.start.offset
+      if (offset !== undefined && source[offset] === '[' && ALERT_MARKER.test(node.value)) {
+        unescapedAlertMarkers.add(node)
+      }
+    })
+  }
+}
+
+function textWithAlertMarkers(
+  node: Text,
+  parent: Parents | undefined,
+  state: State,
+  info: Info,
+): string {
+  const marker = node.value.match(ALERT_MARKER)?.[0]
+  const startsBlockquoteParagraph =
+    parent?.type === 'paragraph' &&
+    parent.children[0] === node &&
+    state.stack[state.stack.length - 3] === 'blockquote'
+  if (!marker || !startsBlockquoteParagraph || !unescapedAlertMarkers.has(node))
+    return state.safe(node.value, info)
+  return marker + state.safe(node.value.slice(marker.length), { ...info, before: ']' })
+}
+
 export function createMinimalProcessor(context: Context): UnifiedProcessor {
   return (
     unified()