Metadata-Version: 2.4
Name: meow-md
Version: 0.2.1
Summary: Markdown renderer with Rich
Author-email: sailorfe <sailorf@proton.me>
License-Expression: MIT
Project-URL: Repository, https://codeberg.org/sailorfe/meow
Keywords: markdown,cat
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Requires-Python: <=4.0,>=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0
Requires-Dist: pygments>=2.16
Requires-Dist: markdown-it-py>=3.0
Dynamic: license-file

# meow

**meow** is a terminal markdown viewer written in python and inspired by [glow](https://github.com/charmbracelet/glow). it's just a `cat` with [Rich](https://github.com/Textualize/rich), though, no file browsing! (yet?)

## features

- uses `LS_COLORS` — respects your terminal colorscheme for all you (us) ricers
- syntax highlighting in fenced codeblocks via Pygments
- styled lists, headers, blockquotes, and **bold** and *italics*
- `git log`-like, terminal height-aware paging

### gripes / future

- [ ] make the checkboxes cuter! glow-style `[ ]` / `[-]` / `[x]`
- [ ] tables...

## installation

install directly from [pypi](https://pypi.org/project/meow-md):

```bash
# run directly without installing
uvx meow-md

# or install globaly
uv tool install meow-md

# or more traditionally
pip install --user meow-md  # if you use pip
pipx install meow-md        # if you use pipx
```

or build from source:

```bash
git clone https://codeberg.org/sailorfe/meow.git
cd meow
uv run -m meow.__main__                 # run directly
# or
uv sync && uv run -m meow.__main__      # for development
```

## usage

```bash
meow README.md
```
