diff --git a/README.md b/README.md
index c8a1f1ad..29286c71 100644
--- a/README.md
+++ b/README.md
@@ -213,8 +213,8 @@ apt-get install build-essential libkrb5-dev gcc g++
* List of these files are passed down to the UI modify its behaviour.
* Currently, supported custom, per folder sorting.
* Dockerized
- * **Markdown based blogging support** - `future plan`
- * you can write some note in the blog.md for every directory
+ * **Markdown based blogging support**
+ * you can write some note in the *.md files for every directory
* bug free :) - `In progress`
diff --git a/demo/images/index.md b/demo/images/index.md
new file mode 100644
index 00000000..42fb551f
--- /dev/null
+++ b/demo/images/index.md
@@ -0,0 +1,86 @@
+# Blog
+
+You can use this feature to create index.md files to your folders and render them in your gallery.
+
+Here are some examples how to format the text:
+
+
+# h1 Heading 8-)
+## h2 Heading
+### h3 Heading
+#### h4 Heading
+##### h5 Heading
+###### h6 Heading
+
+
+## Horizontal Rules
+
+___
+
+---
+
+***
+
+
+## Typographic replacements
+
+Enable typographer option to see result.
+
+(c) (C) (r) (R) (tm) (TM) (p) (P) +-
+
+test.. test... test..... test?..... test!....
+
+!!!!!! ???? ,, -- ---
+
+"Smartypants, double quotes" and 'single quotes'
+
+
+## Emphasis
+
+**This is bold text**
+
+__This is bold text__
+
+*This is italic text*
+
+_This is italic text_
+
+~~Strikethrough~~
+
+
+## Blockquotes
+
+
+> Blockquotes can also be nested...
+>> ...by using additional greater-than signs right next to each other...
+> > > ...or with spaces between arrows.
+
+
+## Lists
+
+Unordered
+
++ Create a list by starting a line with `+`, `-`, or `*`
++ Sub-lists are made by indenting 2 spaces:
+ - Marker character change forces new list start:
+ * Ac tristique libero volutpat at
+ + Facilisis in pretium nisl aliquet
+ - Nulla volutpat aliquam velit
++ Very easy!
+
+Ordered
+
+1. Lorem ipsum dolor sit amet
+2. Consectetur adipiscing elit
+3. Integer molestie lorem at massa
+
+
+1. You can use sequential numbers...
+1. ...or keep all the numbers as `1.`
+
+Start numbering with offset:
+
+57. foo
+1. bar
+
+
diff --git a/docs/index.html b/docs/index.html
index ff82bf95..5621dc13 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -298,6 +298,11 @@
uses ffmpeg and ffprobe to generate video thumbnails
+
Markdown based blogging support
+
+
You can write some note in the *.md files for every directory