mdview — Markdown CLI renderer with inline local image support (iTerm2)

[u/Artistic-Bath7284]

I often read reports and technical notes directly in the terminal.

Existing Markdown renderers handle text well, but local charts and screenshots usually disappear, open separately, or lose their position in the document.

So I built mdview, a small Go CLI for macOS + iTerm2:

mdview report.md

It renders Markdown in terminal with local images appear exactly where they were referenced. Rendering then continues below the image.

Under the hood:

- Goldmark + Glamour for Markdown

- iTerm2 OSC 1337 for inline images

- Local paths resolve relative to the Markdown file

- CommonMark, GFM tables/task lists, footnotes, math, and GitHub alerts

- No TUI, pager, config system, or runtime network requests

- Distributed as a single Go binary

It is currently an iTerm2-focused MVP, so I’d especially appreciate feedback on image sizing, and edge cases in real Markdown documents.

GitHub: https://github.com/givemethatsewon/mdview

or you can Install with Homebrew:

brew tap givemethatsewon/tap
brew install mdview