markdown version of vignette