Update README and example generation script for improved clarity and output formatting

Author: luisggoncalves

README.md

@@ -62,10 +62,7 @@ sqlcompare analyze-diff <diff_id> --missing-current
 
 ## Example outputs
 
-See `examples/` for datasets, commands, and captured outputs.
-
-- Row comparison output: `examples/row_compare.md`
-- Statistical comparison output: `examples/stats_compare.md`
+See [`examples/`](examples/) for datasets, commands, and captured outputs.
 
 ---
 

scripts/generate_examples/run.py

@@ -67,6 +67,14 @@ def main() -> int:
                 "",
                 description,
                 "",
+                "## Command",
+                "",
+                "```bash",
+                command.rstrip("\n"),
+                "```",
+                "",
+                "## Output",
+                "",
                 "```text",
                 output.rstrip("\n"),
                 "```",