diff --git a/README b/README
deleted file mode 100644
index 402219fc2287ff5e37fc36ac68316cb72e6db0a9..0000000000000000000000000000000000000000
--- a/README
+++ /dev/null
@@ -1,29 +0,0 @@
-
-    gexiv2 - A GObject-based Exiv2 wrapper
-    --------------------------------------
-
-  * Introduction
-
-    gexiv2 is a GObject-based wrapper around the Exiv2 library.  It makes the
-    basic features of Exiv2 available to GNOME applications.
-
-    Visit https://wiki.gnome.org/gexiv2 to read about the current state of
-    gexiv2's development and to make sure you're running the latest version.
-
-
-  * Installation & Licensing
-
-    Please consult the INSTALL and COPYING files for more information.
-
-
-  * Contacting the developers
-
-    gexiv2 project page:        https://wiki.gnome.org/Projects/gexiv2
-
-    We also encourage you to discuss gexiv2 on GNOME Discourse.  See
-    https://discourse.gnome.org/tag/gexiv2 for details.
-
-
-
-    Copyright 2016 Software Freedom Conservancy Inc.
-
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..ce984fb57f8845e60a852fef6c8f908b0e46dca6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# gexiv2
+A GObject-based Exiv2 wrapper
+
+## Introduction
+
+    gexiv2 is a GObject-based wrapper around the Exiv2 library.  It makes the
+    basic features of Exiv2 available to GNOME applications.
+
+    Visit https://wiki.gnome.org/gexiv2 to read about the current state of
+    gexiv2's development and to make sure you're running the latest version.
+
+
+## Installation & Licensing
+
+    Please consult the INSTALL and COPYING files for more information.
+
+
+## Contacting the developers
+
+    For reporting issues, please use Gitlab:
+    https://gitlab.gnome.org/GNOME/gexiv2/issues/new
+
+    We also encourage you to discuss gexiv2 on GNOME Discourse.  See
+    https://discourse.gnome.org/tag/gexiv2 for details.
+
+    If you prefer chat, try Shotwell's matrix room:
+    https://matrix.to/#/#shotwell:gnome.org
+
+
+## Further resources
+
+    [Git repository](https://gitlab.gnome.org/GNOME/gexiv2)
+    [API documentation](https://gnome.pages.gitlab.gnome.org/gexiv2/docs)
+    [Issue list](https://gitlab.gnome.org/GNOME/gexiv2/issues)
+    [All source archives](https://download.gnome.org/sources/gexiv2/)
+    [Release history](https://download.gnome.org/sources/gexiv2/)
+
+## Provenience
+
+    The Yorba Foundation inherited the initial gexiv2 code from Mike Gemuende
+    (his initial repository was available at gitorious but is now defunct
+    here).  
+
+    Yorba transferred the copyright to the Software Freedom Conservancy in
+    2016. It has been maintained by people from the GNOME community since.
+
+    Copyright 2016 Software Freedom Conservancy Inc.
+