@inditextech/docouture-antora-extensions 1.1.0 → 1.1.1

package/lib/changelog-pages.js

@@ -194,7 +194,7 @@ function convertBody(lines, logger, versionLabel) {
     }
     const bullet = line.match(/^-\s+\[#(\d+)\]\((\S+?)\)\s*(.*)$/)
     if (bullet) {
-      out.push(`* link:${bullet[2]}[#${bullet[1]}] ${bullet[3]}`.trimEnd())
+      out.push(`* link:${bullet[2]}[#${bullet[1]}] ${unescapeMarkdownBrackets(bullet[3])}`.trimEnd())
       continue
     }
     // Keep a Changelog reference-style link definitions, e.g.
@@ -214,6 +214,21 @@ function convertBody(lines, logger, versionLabel) {
   return out.join('\n')
 }
 
+// This repo's own CHANGELOG.md convention escapes a leading `[type]` tag as
+// `\[type]` (e.g. `\[cli] Add docouture new`) — a Markdown-only concern:
+// GitHub renders CHANGELOG.md as Markdown, where a bare `[foo]` can be read
+// as the start of a reference-style link, so contributors escape it there.
+// AsciiDoc has no equivalent meaning for `\[` — a bare `[...]` in running
+// prose isn't special syntax — so Asciidoctor doesn't strip the backslash
+// either; left alone, it renders as a literal `\` character on the
+// changelog page (GH #223). `\*`/`\_`/`` \` ``/etc are deliberately left
+// untouched here: those escape AsciiDoc's own quoted-text formatting marks
+// the same way they escape Markdown's, so passing them through unchanged is
+// already correct.
+function unescapeMarkdownBrackets(text) {
+  return text.replace(/\\([[\]])/g, '$1')
+}
+
 // `isPrerelease` is only true for the component version Antora flagged
 // `prerelease: true` (see `isPrereleaseVersion` above) — the version built
 // from `main`, still under active development and never itself tagged. Its

package/lib/changelog-pages.spec.js

@@ -157,6 +157,19 @@ describe('registerChangelogPages', () => {
     expect(source).toContain('* link:https://github.com/InditexTech/x/pull/98[#98] [cli] Fix a crash')
   })
 
+  it('unescapes a Markdown-escaped `\\[type]` tag instead of rendering the backslash literally (GH-223)', async () => {
+    const { dir } = writeChangelog(
+      '# Changelog\n\n## [1.0.0] - 2026-01-15\n\n### Added\n\n' +
+        '- [#100](https://github.com/InditexTech/x/pull/100) \\[cli] Add docouture new\n'
+    )
+    const indexFile = createIndexFile('ROOT', 'prerelease', 'main')
+    await run('CHANGELOG.md', { files: [indexFile], playbookDir: dir })
+
+    const source = indexFile.contents.toString()
+    expect(source).toContain('* link:https://github.com/InditexTech/x/pull/100[#100] [cli] Add docouture new')
+    expect(source).not.toContain('\\[cli]')
+  })
+
   it('appends a "no tagged release yet" placeholder on a real version when nothing has been cut', async () => {
     const { dir } = writeChangelog('# Changelog\n\n## [Unreleased]\n\n### Added\n\n- [#1](url) thing\n')
     const indexFile = createIndexFile('ROOT', 'stable', 'main') // a real, tagged version — never shows Unreleased

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inditextech/docouture-antora-extensions",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Antora pipeline extensions shared by docouture documentation sites — per-module navigation metadata (nav_modules)",
   "repository": {
     "type": "git",
@@ -27,7 +27,7 @@
     "@shikijs/themes": "~4.4.0",
     "node-html-parser": "^9.0.1",
     "shiki": "~4.4.0",
-    "@inditextech/docouture-asciidoc-extensions": "1.1.0"
+    "@inditextech/docouture-asciidoc-extensions": "1.1.1"
   },
   "devDependencies": {
     "@antora/content-classifier": "~3.2.0"