diff --git a/hledger-lib/README b/hledger-lib/README.md
similarity index 100%
rename from hledger-lib/README
rename to hledger-lib/README.md
diff --git a/hledger-lib/package.yaml b/hledger-lib/package.yaml
index 47e2cd8ec..5b8c7101b 100644
--- a/hledger-lib/package.yaml
+++ b/hledger-lib/package.yaml
@@ -22,7 +22,7 @@ tested-with: GHC==8.0.2, GHC==8.2.2, GHC==8.4.3, GHC==8.6.5, GHC==8.8.2, GHC==8.
 
 extra-source-files:
 - CHANGES.md
-- README
+- README.md
 - test/unittest.hs
 - test/doctests.hs
 - hledger_csv.5
diff --git a/hledger-ui/README b/hledger-ui/README.md
similarity index 100%
rename from hledger-ui/README
rename to hledger-ui/README.md
diff --git a/hledger-ui/package.yaml b/hledger-ui/package.yaml
index e290ddbd5..695c791c9 100644
--- a/hledger-ui/package.yaml
+++ b/hledger-ui/package.yaml
@@ -24,7 +24,7 @@ tested-with: GHC==8.0.2, GHC==8.2.2, GHC==8.4.3, GHC==8.6.5, GHC==8.8.2, GHC==8.
 
 extra-source-files:
   - CHANGES.md
-  - README
+  - README.md
   - hledger-ui.1
   - hledger-ui.txt
   - hledger-ui.info
diff --git a/hledger-web/README b/hledger-web/README.md
similarity index 100%
rename from hledger-web/README
rename to hledger-web/README.md
diff --git a/hledger-web/package.yaml b/hledger-web/package.yaml
index 8a0a79789..211059833 100644
--- a/hledger-web/package.yaml
+++ b/hledger-web/package.yaml
@@ -24,7 +24,7 @@ tested-with: GHC==8.2.2, GHC==8.4.3, GHC==8.6.5, GHC==8.8.2, GHC==8.10
 
 extra-source-files:
 - CHANGES.md
-- README
+- README.md
 - config/favicon.ico
 - config/keter.yaml
 - config/robots.txt
diff --git a/hledger/README.md b/hledger/README.md
deleted file mode 120000
index 32d46ee88..000000000
--- a/hledger/README.md
+++ /dev/null
@@ -1 +0,0 @@
-../README.md
\ No newline at end of file
diff --git a/hledger/README.md b/hledger/README.md
new file mode 100644
index 000000000..cecf0d59c
--- /dev/null
+++ b/hledger/README.md
@@ -0,0 +1,5 @@
+# hledger
+
+The command-line interface for the hledger accounting system.
+
+More at **<https://hledger.org>**.