markdown version of knb vignette