diff --git a/README.md b/README.md
index 743ebb0..15e34cf 100644
--- a/README.md
+++ b/README.md
@@ -121,6 +121,12 @@ There is a markup language which makes writing long blog posts, memex entries, e
 {=some mono text}
 {(some sans serif text}
 {)some serif text}
+
+// shorthand for a pictured directory/list item
+{%destination|picture}
+
+// shorthand for a shop listing
+{^payment-link|description|img1|alttext1|...|imgn|alttextn}
 ```
 
 # configuration