Improved markdown syntax so it's more readable on command line, fixes #1057