Compile markdown for deployment

depends on #525