From f50f96f3c8e0ba78f38186c79bbeecf7a18ef65b Mon Sep 17 00:00:00 2001
From: Peter Pshenichny <peter.pshenichny@gmail.com>
Date: Wed, 23 Sep 2026 02:06:45 +0200
Subject: [PATCH] fix(markdown): parse escaped wikilink aliases

---
 graphify/extractors/markdown.py |  2 +-
 tests/test_languages.py         | 12 ++++++++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/graphify/extractors/markdown.py b/graphify/extractors/markdown.py
index 4dc2b8feb..0549496ec 100644
--- a/graphify/extractors/markdown.py
+++ b/graphify/extractors/markdown.py
@@ -15,7 +15,7 @@ _MD_INLINE_LINK_RE = re.compile(r'(?<!\!)\[[^\]]*\]\(\s*<?([^)\s>]+)>?(?:\s+[^)]
 
 _MD_REF_DEF_RE = re.compile(r'^\s{0,3}\[[^\]]+\]:\s*<?([^\s>]+)>?')
 
-_MD_WIKILINK_RE = re.compile(r'(?<!\!)\[\[([^\]|#]+)(?:[#|][^\]]*)?\]\]')
+_MD_WIKILINK_RE = re.compile(r'(?<!\!)\[\[([^\]|#]+?)(?:\\?\|[^\]]*|#[^\]]*)?\]\]')
 
 _MD_LINKABLE_EXTS = {".md", ".mdx", ".qmd", ".markdown", ".rst", ".txt"}
 
diff --git a/tests/test_languages.py b/tests/test_languages.py
index 4508bbfdd..8ef40483e 100644
--- a/tests/test_languages.py
+++ b/tests/test_languages.py
@@ -3037,6 +3037,18 @@ def test_markdown_wikilink_vault_fallback(tmp_path):
         assert e["target"] in node_ids, f"link target is a ghost node: {e}"
 
 
+@pytest.mark.parametrize("separator", ["|", "\\|"])
+def test_markdown_wikilink_alias_separator(tmp_path, separator):
+    r"""Obsidian table aliases escape the pipe as ``\|``."""
+    target = tmp_path / "target.md"
+    source = tmp_path / "source.md"
+    target.write_text("# Target\n")
+    source.write_text(f"| Link |\n| --- |\n| [[target{separator}Alias]] |\n")
+    refs = [e for e in extract_markdown(source)["edges"]
+            if e["relation"] == "references"]
+    assert [e.get("target_file") for e in refs] == [str(target)]
+
+
 def test_markdown_wikilink_fallback_path_qualified(tmp_path):
     """[[folder/name]] from a subfolder matches on the full segment suffix."""
     vault = tmp_path / "vault"