diff --git a/documentation.py b/documentation.py
index 57b0a9f..c76bae3 100644
--- a/documentation.py
+++ b/documentation.py
@@ -76,6 +76,9 @@ class Docs:
 
             for project in self.projects:
                 yaml_data = project.get_project_docs_dict()
+                yaml_data["user_docs"] = rewrite_image_paths(
+                    yaml_data["user_docs"], f"projects/{project.get_macro_name()}/docs"
+                )
                 yaml_data["mux_address"] = project.mux_address
 
                 logging.info(f"building datasheet for {project}")
diff --git a/markdown_utils.py b/markdown_utils.py
index 317eb27..a9d9426 100644
--- a/markdown_utils.py
+++ b/markdown_utils.py
@@ -32,6 +32,10 @@ class ImagePathRewriterRenderer(MarkdownRenderer):
         url = token["attrs"]["url"]
         if "://" not in url and not url.startswith("/"):
             token["attrs"]["url"] = os.path.join(self.prefix, url)
+        elif ".." in url:
+            token["attrs"]["url"] = ""
+        elif url.startswith("/"):
+            token["attrs"]["url"] = os.path.join(self.prefix, "../" + url[1:])
         return super().image(token, state)