diff --git a/knowledge base/best practices.placeholder b/knowledge base/best practices.md
similarity index 100%
rename from knowledge base/best practices.placeholder
rename to knowledge base/best practices.md
diff --git a/knowledge base/the automation paradox.placeholder b/knowledge base/the automation paradox.md
similarity index 97%
rename from knowledge base/the automation paradox.placeholder
rename to knowledge base/the automation paradox.md
index af62a79..2eb6d9b 100644
--- a/knowledge base/the automation paradox.placeholder	
+++ b/knowledge base/the automation paradox.md	
@@ -36,8 +36,14 @@ Possible solutions:
 - [We have used too many levels of abstractions and now the future looks bleak]
 - [Why the fuck are we templating yaml?]
 
+<!--
+  References
+  -->
+
+<!-- Knowledge base -->
 [gitops]: gitops.md
 
+<!-- Others -->
 [automating your source of truth - gitops and terraform]: https://www.youtube.com/watch?v=-K8R1OVXPy0
 [software crisis]: https://www.geeksforgeeks.org/software-engineering-software-crisis/
 [we have used too many levels of abstractions and now the future looks bleak]: https://unixsheikh.com/articles/we-have-used-too-many-levels-of-abstractions-and-now-the-future-looks-bleak.html