Improve README with visual examples and add CONTRIBUTING.md

Add light/dark PDF screenshots so people can see the output quality
before installing. Reorganize README to lead with agent skill install.
Add a short CONTRIBUTING.md with dev setup and PR checklist.

Made-with: Cursor

Author: araa47

CONTRIBUTING.md

@@ -0,0 +1,14 @@
+# Contributing
+
+```bash
+uv sync --all-extras --dev
+```
+
+Before submitting a PR, make sure tests and pre-commit hooks pass:
+
+```bash
+uv run pytest
+pre-commit run --all-files
+```
+
+That's it. Keep changes focused and include tests for new features.

README.md

@@ -1,14 +1,20 @@
 # markpdf
 
-Agent-friendly markdown to PDF. Beautiful documents from the terminal.
+Beautiful PDFs from markdown. One command, zero config.
 
-## Install as Agent Skill
+```bash
+markpdf report.md
+```
+
+## Install
+
+Agent skill (Claude Code, Cursor, Codex, Gemini CLI):
 
 ```bash
 npx skills add araa47/markpdf
 ```
 
-Or install the CLI directly:
+CLI:
 
 ```bash
 uv tool install git+https://github.com/araa47/markpdf
@@ -20,21 +26,35 @@ uv tool install git+https://github.com/araa47/markpdf
 markpdf report.md                        # creates report.pdf
 markpdf report.md --dark                  # dark mode
 markpdf report.md -o final.pdf            # custom output path
-markpdf report.md --keep-together         # keep sections on same page
-markpdf --help                            # full docs
+markpdf report.md -k                      # keep sections on same page
 ```
 
-## Why
-
-Most messaging apps (Slack, Discord, Teams, WhatsApp, email) don't render markdown. When an AI agent needs to send a human a formatted document, it can convert markdown to a polished PDF and attach it instead.
-
-## Features
-
-- **Beautiful output** — shadcn/ui zinc palette, clean typography
-- **Dark mode** — `--dark` for dark-themed PDFs
-- **Keep-together** — `-k` tries to keep each section on one page
-- **Images** — local + remote (fetched concurrently)
-- **Full markdown** — headers, bold, italic, code blocks, tables, lists, blockquotes, links, images, task lists, horizontal rules
-- **Extended syntax** — `==highlight==`, `^superscript^`, `~subscript~`, `~~strikethrough~~`
-- **Fast** — async I/O with optional uvloop
-- **Rich CLI** — typer-powered `--help`
+## Output
+
+<table>
+<tr>
+<td><strong>Light</strong></td>
+<td><strong>Dark</strong></td>
+</tr>
+<tr>
+<td><img src="examples/showcase-light-p1.png" width="400" /></td>
+<td><img src="examples/showcase-dark-p1.png" width="400" /></td>
+</tr>
+<tr>
+<td><img src="examples/showcase-light-p4.png" width="400" /></td>
+<td><img src="examples/showcase-dark-p4.png" width="400" /></td>
+</tr>
+</table>
+
+> Source: [`tests/fixtures/showcase.md`](tests/fixtures/showcase.md) | Full PDFs: [`examples/`](examples/)
+
+## Why markpdf?
+
+Most messaging apps (Slack, Discord, Teams, WhatsApp, email) don't render markdown. `markpdf` turns it into a polished PDF — no browser, no LaTeX, no config.
+
+- Full markdown — headers, lists, tables, code blocks, blockquotes, images, task lists
+- Extended syntax — `==highlight==`, `^super^`, `~sub~`, `~~strike~~`
+- Light & dark themes — shadcn/ui zinc palette
+- Remote images fetched concurrently
+- Async I/O with optional uvloop
+- Single binary-style command, agent-friendly