diff --git a/layouts/shortcodes/link-preview.html b/layouts/shortcodes/link-preview.html
index af21b5e..96d140b 100644
--- a/layouts/shortcodes/link-preview.html
+++ b/layouts/shortcodes/link-preview.html
@@ -3,8 +3,7 @@
     <img src='{{.Get 3}}'>
     {{end}}
     <div>
-    <h3>{{ .Get 1 }}</h3>
-    <p>{{.Get 2 }}</p>
+        <h3>{{ .Get 1 }}</h3>
+        <p>{{.Get 2 }}</p>
     </div>
-</a>
-
+</a>
\ No newline at end of file
diff --git a/layouts/shortcodes/readme.md b/layouts/shortcodes/readme.md
new file mode 100644
index 0000000..61003f3
--- /dev/null
+++ b/layouts/shortcodes/readme.md
@@ -0,0 +1,44 @@
+# Shortcodes
+
+My hugo shortcodes for all my themes 
+
+
+## Themes
+- [Freedom](https://code.gabe.rocks/gabriel/freedom) 
+- [Valor](https://code.gabe.rocks/gabriel/valor)
+
+
+### Audio
+
+Embeds an audio player for an audio source
+
+### Embed
+
+Embeds an URL
+
+### Gallery-(start/end)
+Starts and closes a `div` element with the class `gallery`
+
+### gif
+
+A muted video with autoplay and no controls
+
+### image
+
+An image, optionally includes links and captions
+
+### link-preview 
+
+A fancy preview for links
+
+### pdf
+Embeds a pdf
+
+### recent-items
+
+### relevant-items
+
+### video
+
+A video player with controls
+
diff --git a/layouts/shortcodes/recent-items.html b/layouts/shortcodes/recent-items.html
new file mode 100644
index 0000000..a247d74
--- /dev/null
+++ b/layouts/shortcodes/recent-items.html
@@ -0,0 +1,5 @@
+<div class="gallery">
+{{range first 3 .Site.RegularPages}}
+    {{partial "item" .}}
+{{end}}
+</div>
\ No newline at end of file
diff --git a/layouts/shortcodes/relevant-items.html b/layouts/shortcodes/relevant-items.html
new file mode 100644
index 0000000..3150d37
--- /dev/null
+++ b/layouts/shortcodes/relevant-items.html
@@ -0,0 +1,7 @@
+
+<div class="gallery">
+{{ $tag := .Get 0 }}
+    {{range .Site.RegularPages.RelatedTo (keyVals "tags" $tag) }}
+    {{partial "item" .}}
+    {{end}}
+</div>
\ No newline at end of file