diff --git a/README.md b/README.md
new file mode 100644
index 0000000..55f1cc5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+[]()
+
+# nichts
+
+This is my personal collection of NixOS configuration files, made to be simple
+to understand and (somewhat) sane. This project is and will for the forseeable
+future be a work in progress, so expect regular and big changes and instability.
+
+## Layout of this configuraton
+
+This configuraton is split up into _three_ sections:
+
+- **hosts** The configuratons for my different host systems.
+
+- **modules**
+
+- **parts** I heavily rely on flake-parts and store a lot of stuff related to it
+  in there. Also, here you can find me extended lib and all the packages I wrap.
+
+# License
+
+GNU GPL3
+
+# credits
+
+This configuration was only made possible through the help of some amazing
+people! Below are all the repositories I took inspiration from, check them out!
+
+The nix logo was designed by ![jacekpoz](https://jacekpoz.pl)!
+
+```
+![Jacekpoz](https://git.jacekpoz.pl/jacekpoz/niksos.git) 
+![Dragyx](https://github.com/dragyx/nichts) 
+![Sioodmy](https://github.com/sioodmy/dotfiles)
+![Henrik Lissner](https://github.com/hlissner/dotfiles)
+![Diniamo](https://github.com/diniamo/niqs)
+![Fufexan](https://github.com/fufexan)
+![Lokasku](https://github.com/lokasku/nix-config)
+![NotAShelf](https://github.com/notashelf/nyx)
+```
diff --git a/README.org b/README.org
deleted file mode 100644
index e18fe01..0000000
--- a/README.org
+++ /dev/null
@@ -1,35 +0,0 @@
-[[file:.github/logo.svg]]
-* nichts
-This is my personal collection of NixOS configuration files, made to be simple to understand and *sane*.
-** Goals of this configuraton
-This projects pursues some main goals:
-1.
-** Layout of this configuraton
-This configuraton is split up into *three* important parts:
-- hosts
-  The configuraton for my different host systems.
-- modules
-
-- parts
-
-* License
-
-GNU GPL3
-
-* credits
-
-This configuration was only made possible through the help of some amazing people!
-Below are all the repositories I took inspiration from, check them out!
-
-The nix logo was designed by jacekpoz, see his works at [[link:https://jacekpoz.pl]]
-```
-Jacekpoz: https://git.jacekpoz.pl/jacekpoz/niksos.git !
-Dragyx: https://github.com/dragyx/nichts
-Sioodmy: https://github.com/sioodmy/dotfiles
-Heinrik Lissner: https://github.com/hlissner/dotfiles/
-Diniamo: https://github.com/diniamo/niqs
-Fufexan: https://github.com/fufexan
-Lokasku: https://github.com/lokasku/nix-config
-NotAShelf: https://github.com/notashelf/Nyx
-Wallpapers: https://github.com/zhichaoh/catppuccin-wallpapers?tab=readme-ov-file
-```