bahdotsh

bahdotsh / mdterm

Public

A terminal-based Markdown browser.

github.combahdotshmdterm
126
5
100% credibility
Found Mar 11, 2026 at 57 stars 2x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

mdterm is a terminal application for viewing Markdown files with rich formatting, syntax highlighting, interactive navigation, image and diagram rendering, and presentation modes.

How It Works

1
📖 Discover mdterm

You find a cool tool that turns plain Markdown notes into a beautiful, colorful view right in your terminal screen.

2
💻 Set it up

You add the viewer to your computer following simple steps, and it's ready to use in moments.

3
✨ Open your file

Point it at your Markdown file or pipe in text, and instantly see headings, code highlights, images, diagrams, and math all styled perfectly.

4
🔍 Navigate easily

Scroll smoothly with keys or mouse, search with slash, jump to sections with o or brackets, or copy bits to your clipboard.

5
Pick your style
📄
Regular reading

Relax and read notes or docs with full interactive features like themes and line numbers.

🎬
Slide show

Turn your file into slides for a presentation, swiping left-right effortlessly.

😊 Perfect viewing

You now read and present Markdown anywhere with stunning visuals, feeling like a pro without leaving your terminal.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 57 to 126 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is mdterm?

mdterm is a Rust-powered terminal-based Markdown browser that renders files with syntax highlighting, tables, task lists, and interactive navigation via keyboard or mouse. It supports Mermaid diagrams using box-drawing characters, LaTeX math as Unicode, and inline images in Kitty or iTerm2 terminals (with Unicode fallback). Pipe Markdown from curl or commands, or load multiple files and switch with Tab—ideal for a terminal-based Markdown research tool inspired by Obsidian.

Why is it gaining traction?

Unlike basic viewers like glow or mdcat, mdterm packs Obsidian-like features: fuzzy heading search, TOC overlay, in-doc regex search, and link pickers to open URLs by number. Slide mode turns horizontal rules into presentation decks, follow mode auto-reloads files, and HTML export creates themed pages. Developers dig the responsive word-wrapping, themes (dark/light toggle), and clipboard copies for sections or code blocks.

Who should use this?

Terminal-first devs reviewing Markdown docs, notes, or research without firing up a browser—think CLI workflow hackers on Kitty/iTerm2 scripting mdterm for daily notes. Perfect for Rust fans building terminal tools, or anyone prepping slide decks from Markdown for remote talks. Skip if you need full web rendering or avoid Rust installs.

Verdict

Solid niche pick for polished terminal Markdown viewing, but 1.0% credibility score and 53 stars signal early-stage maturity—docs shine, but expect occasional rough edges sans tests. Install via Cargo if terminal TUI Markdown fits your flow; otherwise, wait for more adoption.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.