Guides
Markdown tutorials, comparisons, and how-to articles
Getting Started
- What Is an .md File? What .md means, how Markdown works, and how to open these files on Mac
- How to Write a Markdown File Create your first .md file — headings, links, code blocks, tables with examples
- Markdown Cheat Sheet Quick reference for headings, links, images, code blocks, tables, and more
- README.md Template Copy-paste README templates for GitHub projects — library, CLI, app, and API
- Markdown Tables Guide Syntax, alignment, formatting tips, and tools for creating Markdown tables
Markdown Syntax
- Markdown Bold ** and __ syntax, bold italic, bold in lists, tables, and blockquotes
- Markdown Code Block Inline code, fenced blocks with syntax highlighting, diff syntax, and language IDs
- Markdown Line Break Trailing spaces, backslash, HTML br, and blank lines — 4 methods compared
- Markdown Underline Why Markdown has no underline syntax, and 3 HTML workarounds that work
- Markdown Collapsible Section details/summary toggle, accordion patterns, nested sections, and platform support
Viewing Markdown on Mac
- How to Open .md Files on Mac Set a default viewer, use QuickLook, and stop seeing raw text
- MD Viewer for Mac Free Markdown reader and viewer for macOS — desktop apps, terminal readers, and online tools compared
- Markdown Preview on Mac QuickLook, live preview, and rendered Markdown without leaving Finder
- Best Markdown Viewers for Mac in 2026 6 apps compared — from free native viewers to full editors
- Markdown Editor vs Viewer When you need a full editor and when a lightweight viewer is enough on Mac
- 5 Best Markdown Editors for Mac in 2026 Typora, iA Writer, Bear, MacDown, and MDViewer compared — free and paid options
MDViewer vs Alternatives
- MDViewer vs Typora Free native viewer vs paid WYSIWYG editor — features, pricing, and workflows
- MDViewer vs Marked 2 Two Mac Markdown previewers compared — Git history, editing, and QuickLook
- MDViewer vs Telescopo QuickLook-focused viewer vs full-featured Markdown app for macOS
- MDViewer vs MacMD Viewer Two native SwiftUI viewers with QuickLook — features and pricing compared
- MDViewer vs Simply Markdown Full-featured viewer vs minimal preview companion — which workflow fits?
- MDViewer vs Obsidian Second brain vs instant document viewer — which Markdown approach fits your workflow?
- MDViewer vs VS Code Purpose-built Markdown viewer vs full IDE — instant launch, Mermaid, and QuickLook
- MDViewer vs MacDown Modern maintained viewer vs legacy split-pane editor — both free
- MDViewer vs iA Writer Free viewer vs $50 premium writing app — reading vs writing workflows
- MDViewer vs Bear File-based Markdown viewer vs note-taking database — different approaches
- MDViewer vs MarkText Native SwiftUI viewer vs open-source Electron WYSIWYG editor — both free
Mermaid Diagrams
- What Is Mermaid? Diagram-as-code in Markdown — flowcharts, sequence diagrams, and more from plain text
- Mermaid Flowchart Guide Syntax, shapes, arrows, subgraphs, and copy-paste examples
- Mermaid Sequence Diagram Guide Participants, messages, loops, alt blocks, and real-world examples
- Mermaid vs Draw.io Diagram-as-code vs visual editor — version control, collaboration, and tradeoffs
- Best Mermaid Viewers for Mac 6 tools compared — MDViewer, VS Code, Live Editor, Obsidian, and more
- How to Open Mermaid Files on Mac Open .mmd and .mermaid files from Finder, QuickLook, VS Code, or terminal
- How to Render Mermaid Diagrams on Mac Preview, export, and automate Mermaid rendering — 5 methods compared
AI & Markdown
- Why AI Tools Use Markdown Token efficiency, training data, and why every AI outputs Markdown
- ChatGPT Markdown Output Save, export, and view ChatGPT responses as formatted Markdown files
- Claude Code & Markdown Files How CLAUDE.md gives AI coding agents project context
- Markdown for AI Agents AGENTS.md, copilot-instructions.md, and context files that control AI behavior
- Markdown vs JSON for AI When to use each format for prompts, context, and output
JSON
- How to View JSON Files on Mac Collapsible tree viewers, formatters, and CLI tools for macOS
Converting & Workflows
- Convert .md to PDF on Mac 5 methods — MDViewer export, Print to PDF, Pandoc, VS Code, and grip
- How to Convert PDF to Markdown AI tools, Pandoc, Marker, and online converters for turning PDFs into .md files
- View Markdown from AI Render ChatGPT, Claude, and Copilot output as formatted Markdown
- Online Markdown Viewer View .md files in the browser — drag, drop, read. No install, no upload