use markdown; start to document the dialect