How does showmd improve upon the default macOS Quick Look for Markdown files?
The default macOS Quick Look displays Markdown files as raw text, including all formatting characters like hashes and asterisks. showmd, however, renders these files beautifully, showing the formatted text, tables, images, code blocks with syntax highlighting, LaTeX math, Mermaid diagrams, and even special AI-specific XML tags, making them much more readable.
What specific types of advanced content can showmd render that other previewers might miss?
showmd is unique in its ability to render YAML frontmatter as a collapsible metadata table, display Agentic AI XML tags (like <instructions>, <example>) as labeled blocks, and render both LaTeX math expressions and Mermaid diagrams directly within the preview, which typically appear as raw code in other viewers.
Is showmd a Markdown editor or a note-taking application?
No, showmd is specifically designed as a lightweight Markdown viewer. It is not an editor or a note-taking application, focusing solely on providing an instant and readable preview experience without any bloat.
How do I install and enable showmd on my macOS system?
You can install showmd via Homebrew using brew install --cask johannesnagl/tap/showmd or by direct download of the .dmg file. After opening the app once, you need to enable it in System Settings by navigating to Privacy & Security → Extensions → Quick Look and toggling showmd on. macOS will also prompt for permission to 'access data from other apps' on first launch, which you should allow.
Does showmd support all common Markdown file extensions?
Yes, showmd supports a wide range of Markdown file extensions including .md, .markdown, .mdx, .mdc, .rmd, .qmd, .mdown, .mkd, and .mkdn, ensuring comprehensive compatibility for various Markdown flavors.
Can I switch between the rendered view and the raw source of a Markdown file within showmd?
Yes, showmd provides a convenient toggle that allows you to switch between the beautifully rendered Markdown view and the raw source text of the file with a single click. You can also copy the rendered content as HTML at any time.