diff --git a/examples/flagset/flagset.md b/examples/flagset/README.md
similarity index 100%
rename from examples/flagset/flagset.md
rename to examples/flagset/README.md
diff --git a/examples/flagset/main.go b/examples/flagset/main.go
index ef84da8..324d763 100644
--- a/examples/flagset/main.go
+++ b/examples/flagset/main.go
@@ -28,7 +28,7 @@ func main() {
 		panic(err)
 	}
 
-	write("flagset.md", md)
+	write("README.md", md)
 }
 
 func write(path, content string) {
diff --git a/examples/multiple/command-sub.md b/examples/multiple/README.md
similarity index 100%
rename from examples/multiple/command-sub.md
rename to examples/multiple/README.md
diff --git a/examples/multiple/main.go b/examples/multiple/main.go
index 60a4b91..049a5bc 100644
--- a/examples/multiple/main.go
+++ b/examples/multiple/main.go
@@ -66,7 +66,7 @@ func main() {
 	if err != nil {
 		panic(err)
 	}
-	write("command-sub.md", md)
+	write("README.md", md)
 }
 
 func write(path, content string) {
diff --git a/examples/single/single.md b/examples/single/README.md
similarity index 100%
rename from examples/single/single.md
rename to examples/single/README.md
diff --git a/examples/single/main.go b/examples/single/main.go
index 0d49f64..c13a81a 100644
--- a/examples/single/main.go
+++ b/examples/single/main.go
@@ -35,7 +35,7 @@ func main() {
 	if err != nil {
 		panic(err)
 	}
-	write("single.md", md)
+	write("README.md", md)
 }
 
 func write(path, content string) {