feat: add TOC, ANCHOR, and same-page anchor link conversions (#118)

- **TOC**: `**TOC**` paragraph → Confluence Table of Contents macro (uses macro defaults)
- **ANCHOR**: `**ANCHOR: id**` paragraph → anchor macro
- **Same-page anchor links**: `[text](#id)` → `ac:link` with `ac:anchor`, run before the linkStyle branch so it works under all three modes (smart / wiki / plain)

QUOTE marker from the original PR has been deferred to #125.

Author: stevenhan2

lib/macro-converter.js

@@ -82,6 +82,12 @@ class MacroConverter {
 
     storage = storage.replace(/<code>(.*?)<\/code>/g, '<code>$1</code>');
 
+    // **TOC** paragraph → Confluence Table of Contents macro (uses macro defaults)
+    storage = storage.replace(
+      /<p><strong>TOC<\/strong><\/p>/g,
+      '<ac:structured-macro ac:name="toc" />'
+    );
+
     storage = storage.replace(/<blockquote>(.*?)<\/blockquote>/gs, (_, content) => {
       if (content.includes('<strong>INFO</strong>')) {
         const cleanContent = content.replace(/<p><strong>INFO<\/strong><\/p>\s*/, '');
@@ -112,6 +118,26 @@ class MacroConverter {
     storage = storage.replace(/<th>(.*?)<\/th>/g, '<th><p>$1</p></th>');
     storage = storage.replace(/<td>(.*?)<\/td>/g, '<td><p>$1</p></td>');
 
+    // **ANCHOR: id** paragraph → Confluence anchor macro
+    storage = storage.replace(
+      /<p><strong>ANCHOR: (.*?)<\/strong><\/p>/g,
+      '<ac:structured-macro ac:name="anchor"><ac:parameter ac:name="">$1</ac:parameter></ac:structured-macro>'
+    );
+
+    // Same-page anchor links (href="#id") → ac:link with ac:anchor. Must run
+    // before the general link conversion below so the #id pattern is not
+    // consumed by the generic <a href> replacement (and so it works under
+    // all linkStyle modes, including "plain" which leaves <a> tags as-is).
+    storage = storage.replace(/<a href="#(.*?)">(.*?)<\/a>/gs, (_, anchor, body) => {
+      const text = body
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, '\'');
+      return `<ac:link ac:anchor="${anchor}"><ac:plain-text-link-body><![CDATA[${text}]]></ac:plain-text-link-body></ac:link>`;
+    });
+
     // Convert links based on linkStyle:
     //   "smart" — Cloud smart links (<a data-card-appearance="inline">)
     //   "plain" — simple <a href>; workaround for "Cannot handle: DefaultLink"

tests/macro-converter.test.js

@@ -66,3 +66,54 @@ describe('MacroConverter', () => {
     });
   });
 });
+
+describe('MacroConverter markdownToStorage marker conventions', () => {
+  // isCloud: true so link output matches the smart-link branch in mixed tests.
+  const converter = new MacroConverter({ isCloud: true });
+
+  describe('TOC', () => {
+    test('**TOC** becomes Table of Contents macro', () => {
+      const result = converter.markdownToStorage('**TOC**');
+      expect(result).toContain('<ac:structured-macro ac:name="toc" />');
+      expect(result).not.toContain('**TOC**');
+    });
+  });
+
+  describe('ANCHOR', () => {
+    test('**ANCHOR: id** becomes anchor macro with given id', () => {
+      const result = converter.markdownToStorage('**ANCHOR: my-section**');
+      expect(result).toContain('<ac:structured-macro ac:name="anchor">');
+      expect(result).toContain('<ac:parameter ac:name="">my-section</ac:parameter>');
+      expect(result).not.toContain('**ANCHOR');
+    });
+  });
+
+  describe('same-page anchor links', () => {
+    test('[text](#id) becomes ac:link with ac:anchor', () => {
+      const result = converter.markdownToStorage('[Jump](#my-section)');
+      expect(result).toContain('<ac:link ac:anchor="my-section">');
+      expect(result).toContain('<![CDATA[Jump]]>');
+    });
+
+    test('anchor-link conversion runs before general link conversion on Cloud', () => {
+      const result = converter.markdownToStorage(
+        '[Jump](#my-section) and [External](https://example.com)'
+      );
+      expect(result).toContain('ac:anchor="my-section"');
+      expect(result).toContain('data-card-appearance="inline"');
+    });
+
+    test('anchor-link conversion runs before general link conversion on Server/DC', () => {
+      const serverConverter = new MacroConverter({ isCloud: false });
+      const result = serverConverter.markdownToStorage(
+        '[Jump](#my-section) and [External](https://example.com)'
+      );
+      expect(result).toContain('ac:anchor="my-section"');
+      // External link should get the ac:link + ri:url storage format, not be
+      // double-wrapped by the anchor replacement.
+      expect(result).toContain('ri:value="https://example.com"');
+      expect(result).not.toContain('ac:anchor="https');
+    });
+  });
+
+});