How can I have a variable for my site name and build external URLs within documentation?

[nh916]

I want to build URLS with something like [my link](my_site_variable/about/) instead of [my link](https://my_website.com)

How can I do this within the documentation.

I tried putting in a site_name variable at the top of the YAML file that is gloabl.

site_url: https://my-website.org

and I tried putting it in the extra section

extra:
  homepage: https://my-website.org

and I tried linking to them in my documentation like

[my link]({{ extra.homepage}}/about/)

and

[my link]({{ homepage}}/about/)

however, both did not recognize it as a variable and tried taking me to my local site.

Is there a way that I can get this to work for me?

[squidfunk]

I think you might be looking for the macros plugin.

[mks-d]

And for those using GitHub Actions for their MkDocs site deployment, this (example here) is needed in their ci.yml file since the plugin must be installed beforehand:

- run: pip install mkdocs-macros-plugin