diff --git a/architecture-docs/entity-relations.html b/architecture-docs/entity-relations.html
deleted file mode 100644
index 862de45..0000000
--- a/architecture-docs/entity-relations.html
+++ /dev/null
@@ -1,4 +0,0 @@
-
fediversity entity relations
-![]()
diff --git a/architecture-docs/entity-relations.md b/architecture-docs/entity-relations.mmd
similarity index 93%
rename from architecture-docs/entity-relations.md
rename to architecture-docs/entity-relations.mmd
index 32ccdb2..ff5a854 100644
--- a/architecture-docs/entity-relations.md
+++ b/architecture-docs/entity-relations.mmd
@@ -1,6 +1,3 @@
-# fediversity entity relations
-
-```mermaid
---
title: Fediversity entity relations
---
@@ -23,4 +20,3 @@ erDiagram
deployed ||--|{ application : describes
application ||--o{ version : follows
deployed }|--o{ version : follows
-```
diff --git a/architecture-docs/entity-relations.svg b/architecture-docs/entity-relations.svg
new file mode 100644
index 0000000..8dfacbb
--- /dev/null
+++ b/architecture-docs/entity-relations.svg
@@ -0,0 +1 @@
+
\ No newline at end of file