The current markdown parser in Stash is bad - it doesn't work well with indenting and is really lacking when compared to github's parser.

See the below example of how indenting with code blocks should look - it fails to render properly in Stash:

http://spec.commonmark.org/dingus.html?text=%23%23%20Types%0A%0A%20%20-%20Primitives%20-%20When%20you%20access%20a%20primitive%20type%20you%20work%20directly%20on%20its%20value%0A%20%20%20%20%20%20%0A%20%20%20%20%2B%20%60string%60%0A%20%20%20%20%2B%20%60number%60%0A%20%20%20%20%2B%20%60boolean%60%0A%20%20%20%20%2B%20%60null%60%0A%20%20%20%20%2B%20%60undefined%60%0A%0A%20%20%20%20%60%60%60javascript%0A%20%20%20%20var%20foo%20%3D%201%2C%0A%20%20%20%20%20%20%20%20bar%20%3D%20foo%3B%0A%20%20%20%20%0A%20%20%20%20bar%20%3D%209%3B%0A%20%20%20%20%0A%20%20%20%20console.log(foo%2C%20bar)%3B%20%2F%2F%20%3D%3E%201%2C%209%0A%20%20%20%20%60%60%60%0A%0A%20%20-%20Complex%20types%20-%20When%20you%20access%20a%20complex%20type%20you%20work%20on%20a%20reference%20to%20its%20value%0A%20%20%0A%20%20%20%20%2B%20%60object%60%0A%20%20%20%20%2B%20%60array%60%0A%20%20%20%20%2B%20%60function%60%0A%20%20%0A%20%20%20%20%60%60%60javascript%0A%20%20%20%20var%20foo%20%3D%20%5B1%2C%202%5D%2C%0A%20%20%20%20%20%20%20%20bar%20%3D%20foo%3B%0A%20%20%20%20%0A%20%20%20%20bar%5B0%5D%20%3D%209%3B%0A%20%20%20%20%0A%20%20%20%20console.log(foo%5B0%5D%2C%20bar%5B0%5D)%3B%20%2F%2F%20%3D%3E%209%2C%209%0A%20%20%20%20%60%60%60

Moving to the standard markdown language "Common Markdown" would greatly improve the use of the markdown files within stash.

http://commonmark.org/