Update README and manpage.

Author: davejacobs

README.md

@@ -7,11 +7,11 @@ Transform your plain text documents into beautiful HTML documents with customiza
 ## Why Mint?
 
 - **Focus on writing** – Keep documents as plain text
-- **Beautiful output** – Professional-looking HTML ready for print or web
-- **Digital gardens** – Easily publish linked sets of HTML documents from tools like Obsidian
+- **Beautiful output by default** – Professional-looking HTML ready for print or web
+- **Customizable** – Create your own templates and styles
 - **Version control-friendly** – Text documents work great with Git
 - **Scriptable** – Automate document processing and analysis
-- **Highly customizable** – Create your own templates and styles
+- **Native support for digital gardens** – Easily publish linked sets of HTML documents from tools like Obsidian
 
 ## Installation
 
@@ -42,6 +42,12 @@ same thing.
 ### Basic commands
 
 ```bash
+# Preview a document in the browser on a local server
+mint Document.md --serve
+
+# Preview on a specific port
+mint Document.md --serve --serve-port 8080
+
 # Publish a single document with a default template
 mint Document.md
 
@@ -73,6 +79,8 @@ mint content/**/*.md --destination public --no-preserve-structure
 
 | Flag | Description |
 |------|-------------|
+| `--serve` | Publish files and preview them on a local HTTP server |
+| `--serve-port PORT` | Port for the local server (default: 4000) |
 | `-t, --template TEMPLATE` | Use a built-in template (combines layout + style) |
 | `-l, --layout LAYOUT` | Specify only the template layout, by name |
 | `-s, --style STYLE` | Specify only the template style, by name |
@@ -159,14 +167,6 @@ The `original` mode is particularly useful for template development, as it allow
 files and see changes immediately without republishing. In this mode, `@import` statements in CSS
 files will be included as additional `<link>` tags.
 
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Run the tests: `rspec`
-5. Submit a pull request
-
 ## License
 
 MIT License. See [LICENSE](LICENSE) for details.

man/mint.1

@@ -11,6 +11,12 @@ Mint transforms your plain text documents into beautiful documents. It makes tha
 .BR \-h ", " \-\-help
 Show mint usage information
 .TP
+.BR \-\-serve
+Publish files to a temporary directory and serve them on a local HTTP server. The server strips \fI.html\fR extensions from URLs so that \fI/document\fR serves \fIdocument.html\fR. The temporary directory is deleted when the server is stopped. This option forces inline style mode so that CSS is always self-contained.
+.TP
+.BR \-\-serve\-port " " \fIPORT\fR
+Port for the local server started by \fB--serve\fR. Default is 4000.
+.TP
 .BR \-d ", " \-\-destination " " \fIDIRECTORY\fR
 Specify a destination directory
 .TP
@@ -102,6 +108,16 @@ mint Document.md --opt navigation-depth=4
 .RE
 .SH EXAMPLES
 .TP
+Preview a document in the browser:
+.nf
+mint Document.md --serve
+.fi
+.TP
+Preview on a specific port:
+.nf
+mint Document.md --serve --serve-port 8080
+.fi
+.TP
 Transform a single Markdown file:
 .nf
 mint Document.md