diff --git a/README b/README
new file mode 100644
index 0000000..8c6c3e3
--- /dev/null
+++ b/README
@@ -0,0 +1,23 @@
+SYNOPSIS
+
+This is a set of pacman hooks and script that causes to automatically take a pre
+and post snapshot before and after pacman transactions, similar to how YaST does
+with OpenSuse. This provides a simple way to undo changes to a system after a
+pacman transaction.
+
+INSTALLATION
+
+Install the "snap-pac" package using pacman. Alternatively clone the repository
+and run "make install". I have signed the release tarball and commits with my
+PGP key. The key's fingerprint is "8535CEF3F3C38EE69555BF67E4B5E45AA3B8C5C3".
+
+DOCUMENTATION
+
+See "man 7 snap-pac" after installation.
+
+TROUBLESHOOTING
+
+After reviewing the man page, check the issues page and file a new issue if your
+problem is not covered:
+
+https://github.com/wesbarnett/snap-pac/issues
diff --git a/README.md b/README.md
deleted file mode 100644
index 4369307..0000000
--- a/README.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# snap-pac
-
-This is a set of pacman hooks and script that causes to automatically take a pre
-and post snapshot before and after pacman transactions, similar to how YaST does
-with OpenSuse. This provides a simple way to undo changes to a system after a
-pacman transaction.
-
-## Installation
-
-Install the `snap-pac` package using pacman.
-
-## PGP Key
-
-I have signed the release tarball with my PGP key. The key's fingerprint is
-`8535CEF3F3C38EE69555BF67E4B5E45AA3B8C5C3`.
-
-## Documentation
-
-See `man 7 snap-pac` after installation.