From 71c0ea31498c657bd9f0f78c7bd5392b5bed5c25 Mon Sep 17 00:00:00 2001
From: brennanb2025 <brennankbenson@gmail.com>
Date: Tue, 23 Jun 2026 19:39:27 -0700
Subject: [PATCH] Preserve inline-code link labels in rich markdown

---
 .../editor/markdown-round-trip.test.ts        | 59 +++++++++++++++++++
 .../editor/rich-markdown-extensions.ts        | 17 +++++-
 2 files changed, 75 insertions(+), 1 deletion(-)

diff --git a/src/renderer/src/components/editor/markdown-round-trip.test.ts b/src/renderer/src/components/editor/markdown-round-trip.test.ts
index 551902aee27..a06bc883b55 100644
--- a/src/renderer/src/components/editor/markdown-round-trip.test.ts
+++ b/src/renderer/src/components/editor/markdown-round-trip.test.ts
@@ -20,6 +20,35 @@ function roundTripMarkdown(content: string): string {
   }
 }
 
+function markdownAfterTextReplace(content: string, search: string, replacement: string): string {
+  const editor = new Editor({
+    element: null,
+    extensions: createRichMarkdownExtensions(),
+    content: encodeRawMarkdownHtmlForRichEditor(content),
+    contentType: 'markdown'
+  })
+
+  try {
+    let from: number | null = null
+    editor.state.doc.descendants((node, pos) => {
+      if (from !== null || !node.isText || !node.text) {
+        return
+      }
+      const index = node.text.indexOf(search)
+      if (index !== -1) {
+        from = pos + index
+      }
+    })
+    if (from === null) {
+      throw new Error(`Missing text: ${search}`)
+    }
+    editor.view.dispatch(editor.state.tr.insertText(replacement, from, from + search.length))
+    return editor.getMarkdown().trimEnd()
+  } finally {
+    editor.destroy()
+  }
+}
+
 function slashCommandMarkdown(commandId: SlashCommandId): string {
   const editor = new Editor({
     element: null,
@@ -158,6 +187,36 @@ describe('rich markdown round trip', () => {
     )
   })
 
+  it('preserves links whose label is inline code', () => {
+    expect(roundTripMarkdown('Link to [`foo.md`](./foo.md) here\n')).toBe(
+      'Link to [`foo.md`](./foo.md) here'
+    )
+  })
+
+  it('preserves links whose label is inline code after an editor transaction', () => {
+    expect(
+      markdownAfterTextReplace('Link to [`foo.md`](./foo.md) here\n', 'here', 'here saved')
+    ).toBe('Link to [`foo.md`](./foo.md) here saved')
+  })
+
+  it('preserves links when editing inside an inline-code label', () => {
+    expect(markdownAfterTextReplace('Link to [`foo.md`](./foo.md) here\n', 'foo', 'bar')).toBe(
+      'Link to [`bar.md`](./foo.md) here'
+    )
+  })
+
+  it('preserves titled links whose label is inline code', () => {
+    expect(roundTripMarkdown('Link to [`foo.md`](./foo.md "Foo") here\n')).toBe(
+      'Link to [`foo.md`](./foo.md "Foo") here'
+    )
+  })
+
+  it('preserves bold link labels as formatted link text', () => {
+    expect(roundTripMarkdown('Link to [**bold**](./foo.md) here\n')).toBe(
+      'Link to [**bold**](./foo.md) here'
+    )
+  })
+
   it('does not surface Linear issue reference definitions as description text', () => {
     const input = [
       '- [x] [H-279]',
diff --git a/src/renderer/src/components/editor/rich-markdown-extensions.ts b/src/renderer/src/components/editor/rich-markdown-extensions.ts
index 6d2dd37cae7..353ecfbb840 100644
--- a/src/renderer/src/components/editor/rich-markdown-extensions.ts
+++ b/src/renderer/src/components/editor/rich-markdown-extensions.ts
@@ -1,6 +1,7 @@
 import type { AnyExtension } from '@tiptap/core'
 import StarterKit from '@tiptap/starter-kit'
 import Link from '@tiptap/extension-link'
+import { Code } from '@tiptap/extension-code'
 import Image from '@tiptap/extension-image'
 import CodeBlockLowlight from '@tiptap/extension-code-block-lowlight'
 import Placeholder from '@tiptap/extension-placeholder'
@@ -28,6 +29,18 @@ import { createRichMarkdownAnnotationHighlightExtension } from './rich-markdown-
 
 const lowlight = createLowlight(common)
 
+const RichMarkdownLink = Link.extend({
+  // Why: link's priority must stay below code's default 100 so Markdown
+  // serializes code-styled labels as [`label`](href).
+  priority: 90
+})
+
+const RichMarkdownCode = Code.extend({
+  // Why: Markdown supports linked code labels, so code cannot exclude the link
+  // mark even though it should still stay exclusive with emphasis marks.
+  excludes: 'code bold italic strike underline'
+})
+
 export function createRichMarkdownExtensions({
   includePlaceholder = false
 }: {
@@ -39,8 +52,10 @@ export function createRichMarkdownExtensions({
     // preview and then still lose syntax on save.
     StarterKit.configure({
       link: false,
+      code: false,
       codeBlock: false
     }),
+    RichMarkdownCode,
     CodeBlockLowlight.extend({
       addNodeView() {
         return safeReactNodeViewRenderer(RichMarkdownCodeBlock)
@@ -49,7 +64,7 @@ export function createRichMarkdownExtensions({
       lowlight,
       defaultLanguage: null
     }),
-    Link.configure({
+    RichMarkdownLink.configure({
       openOnClick: false,
       autolink: true,
       linkOnPaste: true