See https://docs.ropensci.org/rperseus/ and this comment from Hadley: https://github.com/ropensci/rotemplate/issues/19#issuecomment-506315565 You can also have a look where other packages store `readme.md` figures: - https://github.com/ropensci/tidyhydat/ - https://github.com/ropensci/drake/