# Install mdv with Homebrew Styled terminal markdown viewer. Version 1.7.5 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:mdv ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install mdv ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:mdv - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.7.5 - **Source summary:** Styled terminal markdown viewer - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** BSD-3-Clause - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - mdv (cli) - mdv (alias) ## Dependencies - libyaml - python@3.14 ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.7.5 - Local data: ok - Upstream repository: https://github.com/axiros/terminal_markdown_viewer - info: No package-manager update timestamp was available. - info: No cached GitHub release or tag data was available. ## Project history and usage mdv, from the terminal_markdown_viewer repository, is a Python styled Markdown viewer for terminals. It targets remote editing, browserless environments, CLI help output, and colored reading of Markdown in 256-color terminals. ### Project history The public GitHub repository was created on 2015-07-12. The README explains the motivation as avoiding browser context switches while editing Markdown remotely, especially in larger mkdocs projects or constrained hop-machine environments. The project began as a proof-of-concept hack, and the README is candid that complex Markdown and inline HTML are outside its strongest use cases. Over time it added themes, tables, admonitions, file and directory monitoring, source-code highlighting, library usage, and Python 3 support. ### Adoption history The README documents `pip install mdv`, a MacPorts entry, and FreeBSD package availability. The input package-manager facts show Homebrew packaging for the same executable name. GitHub metadata showed sustained attention for a terminal Markdown renderer, with more than a thousand stars and over a hundred forks by 2026. ### How it is used CLI users run `mdv [OPTIONS] MDFILE` to render Markdown with themes, link styles, source-code highlighting, width control, file monitoring, directory monitoring, and optional HTML output. The README also documents inline library use from Python, environment variables `MDV_THEME` and `MDV_CODE_THEME`, YAML CLI-argument defaults in `$HOME/.mdv`, and executable Python customization in `$HOME/.mdv.py`. ### Why package nerds care mdv matters in package-manager culture as one of the older terminal Markdown viewers that made README rendering, colored CLI docs, and remote-server Markdown inspection feasible without Node, Pandoc, or a browser. Its README's own alternatives section places it among JavaScript terminal renderers, Pandoc-to-browser or man-page pipelines, and vimcat, while arguing for a Python package that handles tables, admonitions, and themes in a terminal. ### Timeline - 2015: Public GitHub repository created. - 2016: README update noted pip installation, setup.py-based dependencies, light-theme work, stdin support, wrapping fixes, and test additions. - 2018: README update noted merged PRs, Python 3 support, header numbering, and simpler config handling. - 2023: README update noted release 1.7.5 and a mailto link fix. ### Related projects - The README discusses msee, ansidown, ansimd, nd, Pandoc with terminal browsers or groff/man output, and vimcat as alternatives. - The README credits Pygments, tabulate, and Python Markdown as supporting projects. ### Sources - - - source_facts.homepage - source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.mdv, ~/.mdv.py ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** mdv - **Version Scheme:** 0 - **Revision:** 1 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [glow](https://www.automicvault.com/pkg/brew/glow/) - Shares av.db curated category or tags: cli, developer-tools, markdown, terminal, viewer. - [mandown](https://www.automicvault.com/pkg/brew/mandown/) - Shares av.db curated category or tags: cli, developer-tools, markdown, terminal, viewer. - [comrak](https://www.automicvault.com/pkg/brew/comrak/) - Shares av.db curated category or tags: cli, developer-tools, markdown. - [github-markdown-toc](https://www.automicvault.com/pkg/brew/github-markdown-toc/) - Shares av.db curated category or tags: cli, developer-tools, markdown. - [grip](https://www.automicvault.com/pkg/brew/grip/) - Shares av.db curated category or tags: cli, developer-tools, markdown. - [hoedown](https://www.automicvault.com/pkg/brew/hoedown/) - Shares av.db curated category or tags: cli, developer-tools, markdown. - [markdown-oxide](https://www.automicvault.com/pkg/brew/markdown-oxide/) - Shares av.db curated category or tags: cli, developer-tools, markdown. - [markdownlint-cli](https://www.automicvault.com/pkg/brew/markdownlint-cli/) - Shares av.db curated category or tags: cli, developer-tools, markdown. ## Combined YAML source View the package source record on GitHub. [combined/mdv.yml](https://github.com/automic-vault/db/blob/main/combined/mdv.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph