semvec/pypi-packages huggingface dataset:
viewmd 0.1.5
Simple HTTP server for viewing Markdown files in your browser
License: MIT
Requires Python: >=3.7
Keywords: markdown, viewer, http-server, cli

# viewmd

A simple HTTP server for viewing Markdown files in your browser.

## Installation

```bash
pipx install viewmd
```

## Quick Start

```bash
# Run from any directory
viewmd

# Open http://localhost:8000
```

## What It Does

- **Markdown files** (`.md`) - Rendered as HTML with nice styling
- **Text files** (`.py`, `.json`, `.gitignore`, etc.) - Displayed in browser
- **Directories** - Shows file listing, auto-displays `README.md`
- **Other files** - Served normally (images, PDFs, etc.)

## Usage

```bash
viewmd          # Starts on port 8000
viewmd 3000     # Custom port
```

## Upgrade

```bash
pipx upgrade viewmd
```

## Uninstallation

```bash
pipx uninstall viewmd
```