如何通过MyST替换实现公共地址与文件名拼接的超链接？

以下是两种可行的实现方式，解决你在Sphinx+MyST环境下的URL拼接需求：

方法一：启用MyST宏扩展（推荐） #

MyST的宏扩展支持变量定义与字符串拼接，能直接在Markdown链接中实现动态拼接：

1. 配置Sphinx的conf.py
   启用宏扩展并定义全局公共地址变量：

   extensions = [
       # 保留你已有的扩展（如myst_parser、breathe等）
       "myst_parser.ext.macros",  # 新增宏扩展
   ]
   
   # 定义全局宏变量
   myst_macros = {
       "COMMON_ADDRESS": "https://common/source/html/"
   }
   

2. 在Markdown文档中使用
   利用~运算符完成字符串拼接，直接写原生Markdown链接：

   [This is a]({{ COMMON_ADDRESS ~ 'a.html' }})
   [This is b]({{ COMMON_ADDRESS ~ 'b.html' }})
   [This is c]({{ COMMON_ADDRESS ~ 'c.html' }})
   

方法二：RST替换结合eval-rst块 #

如果不想启用宏扩展，可借助RST的替换机制，通过eval-rst块切换解析上下文：

1. 配置Sphinx的conf.py
   通过rst_prolog定义公共地址替换变量：

   rst_prolog = """
   .. |COMMON_ADDRESS| replace:: https://common/source/html/
   """
   

2. 在Markdown文档中使用
   用eval-rst块编写RST风格的链接，让替换变量生效：

   `This is a <|COMMON_ADDRESS|a.html>`_
   `This is b <|COMMON_ADDRESS|b.html>`_
   `This is c <|COMMON_ADDRESS|c.html>`_
   

为什么你之前的方法失败？ #

• 普通myst_substitutions仅支持纯文本替换，无法在Markdown链接的括号内完成动态拼接（解析优先级导致替换逻辑失效）。
• 单纯的rst_prolog替换不会作用于Markdown原生链接语法，必须通过eval-rst切换到RST解析环境才能触发替换。

内容的提问来源于stack exchange，提问作者karim