diff --git a/docs/authoring/introduction.mdx b/docs/authoring/introduction.mdx
index 3d83c3ec..29aea169 100644
--- a/docs/authoring/introduction.mdx
+++ b/docs/authoring/introduction.mdx
@@ -80,7 +80,7 @@ result:
 
 Plus:
 - any [GitHub Flavored Markdown](https://github.github.com/gfm/) syntax.
-- all exported [`components/mdx/index.tsx`](components/mdx/index.tsx) MDX components.
+- all exported [`components/mdx/index.tsx`](https://github.com/pmndrs/docs/blob/main/src/components/mdx/index.tsx) MDX components.
 
 See the following pages for detailed documentation on each custom component.
 
diff --git a/docs/getting-started/introduction.mdx b/docs/getting-started/introduction.mdx
index 48329d55..e971267b 100644
--- a/docs/getting-started/introduction.mdx
+++ b/docs/getting-started/introduction.mdx
@@ -124,7 +124,7 @@ becomes (for a `MDX_BASEURL=http://localhost:60141` value):
 `http://localhost:60141` being the `MDX` folder served.
 
 > [!TIP]
-> When deployed on GitHub Pages, `MDX_BASEURL` will typically value something like `https://github.com/pmndrs/uikit/raw/main/docs`, thanks to [`build.yml`](.github/workflows/build.yml) rule.
+> When deployed on GitHub Pages, `MDX_BASEURL` will typically value something like `https://github.com/pmndrs/uikit/raw/main/docs`, thanks to [`build.yml`](https://github.com/pmndrs/docs/blob/main/.github/workflows/build.yml) rule.
 
 </details>