diff --git a/.Rbuildignore b/.Rbuildignore
index ee1e990..b29b3b1 100644
--- a/.Rbuildignore
+++ b/.Rbuildignore
@@ -9,3 +9,5 @@
 ^inst/doc/dbhydroR\.log$
 ^inst/doc/dbhydroR-concordance\.tex$
 ^inst/doc/dbhydroR\.tex$
+^README\.Rmd$
+^README-.*\.png$
diff --git a/README.md b/README.Rmd
similarity index 94%
rename from README.md
rename to README.Rmd
index 3a422cb..9a5650a 100644
--- a/README.md
+++ b/README.Rmd
@@ -1,3 +1,16 @@
+---
+output: github_document
+---
+
+<!-- README.md is generated from README.Rmd. Please edit that file -->
+
+```{r, echo = FALSE}
+knitr::opts_chunk$set(
+  collapse = TRUE,
+  comment = "#>",
+  fig.path = "README-"
+)
+```
 
 ![](inst/images/profile.png)