# Mado Mado is a native macOS app for reading, navigating, presenting, exporting, and sharing AI-generated Markdown documents. Human page: https://madomd.com/ Markdown page for AI agents: https://madomd.com/index.md Connector contract for AI agents: https://madomd.com/connectors.md ## Summary AI writes Markdown. Mado makes it readable. A native macOS app for opening AI-generated Markdown as a polished document, jumping through long files with an Outline, and sharing a clean page when the work is ready. Mado is reading-first. It includes lightweight editing, but it is not positioned as a full Markdown editor, IDE, note-taking system, or knowledge base. ## Core Workflow ### Writing got faster. Reading got harder. AI can produce implementation plans, product specs, design notes, meeting summaries, and reports in seconds. People still need to read them carefully, make decisions, and pass them along. Markdown is excellent for generation and storage. Mado is designed for the reading step that comes next. - Turn dense AI output into readable documents. - Review product and engineering notes without editor noise. - Move from generated text to decisions faster. ### Read the document before you edit it. Mado renders Markdown as a document with clear typography, spacing, syntax highlighting, images, tables, task lists, frontmatter, and code blocks. Source, Visual, Split, and Outline navigation are there when you need them. The default experience stays focused on reading. - Document-first rendering - Source, Visual, and Split layouts - Outline jumps for long documents - Theme-aware code highlighting - Local images and file URLs ### Open a folder. Navigate Markdown like a workspace. AI-generated documents rarely arrive alone. Open a folder, browse Markdown as a tree, jump with Go to File, open the document Outline, return to recent work, and keep important folders close. Mado borrows the speed of developer tools without becoming another code editor. - Folder workspace - Sidebar file tree - Outline for headings inside the current document - Command Palette - Recents and Favorites ### Give every document a finished reading view. Mado Pro includes document presentations with typography, spacing, and layouts built for professional reading. Turn raw AI output into something you can send to a teammate, client, reviewer, or finance partner. Exported documents can carry their own Table of Contents so long files stay navigable outside Mado. - Premium document presentations - Designed typography and spacing - Preview before export - Export with the selected presentation and Table of Contents ### Share exactly what you see. Export clean HTML with a generated Table of Contents, or share a readable link in one click — to CodeSandbox, PageDrop, or Mado Pages — so others see the same document without installing Mado. Send it in Slack, email, Linear, Notion, or wherever the discussion happens. - Standalone HTML & PDF export with Table of Contents - One-click share to CodeSandbox, PageDrop, or Mado Pages - Add your own destination with a Connector - Manage shared pages — copy, open, or reclaim ## Outline and Table of Contents Mado builds an Outline from Markdown headings so readers can jump through long documents and keep track of the current section. Mado can export standalone HTML and PDF with a generated Table of Contents based on document headings. ## Reading Capabilities - Readable rendering: Readable spacing, headings, tables, task lists, code blocks, and local images without manual styling. - Native macOS workflow: A Swift macOS app built around normal files, folder workspaces, keyboard navigation, and fast rendering. - Focused without feeling limited: Mado stays simple, but still gives you the views, exports, themes, and shortcuts a real workflow needs. ## Connectors Connectors are export destinations for generated Markdown HTML. They are intentionally small and are documented for AI-assisted generation at https://madomd.com/connectors.md. - Mado Pages: https://madomd.com - CodeSandbox: https://codesandbox.io - PageDrop: https://pagedrop.io - Custom: /connectors ## Pricing ### Free $0. Everything you need to read Markdown comfortably on macOS. - Native Markdown reading - Folder workspace - Source, Visual, and Split views - Outline navigation - Basic document presentations - Local HTML and PDF export with Table of Contents - Recents and Favorites ### Pro $9.99 one-time. For people who regularly present and share Markdown. - Premium document presentations - Export with Pro presentations and Table of Contents - Hosted sharing - Connectors - Future professional features ### Teams Coming soon. For organizations that want shared publishing workflows. - Team seats - Organization-managed access - Shared connectors - Internal destinations - Invoice payment ## Navigation - Why Mado: #why - Reading: #reading - Presentations: #present - Share: #share - Connectors: /connectors - Pricing: #pricing - FAQ: #faq ## FAQ ### What is Mado? Mado is a native macOS app for reading, navigating, presenting, and sharing Markdown documents, especially Markdown produced by AI tools and software workflows. ### Is Mado a Markdown editor? Mado includes lightweight editing, but it is designed reading-first. It is not trying to replace VS Code, Obsidian, or a full writing environment. ### Why is Mado useful for AI-generated Markdown? AI tools can generate long plans, specs, reports, and notes quickly. Mado helps you read those documents comfortably, move through folders, and share readable versions with others. ### Can Mado open folders? Yes. Mado opens a folder as a Markdown workspace with a sidebar file tree, quick navigation, recents, and favorites. ### Can Mado export HTML? Yes. Mado can export standalone HTML and PDF. Exported documents include heading anchors and a Table of Contents when the document has enough sections. Pro users can export using premium document presentations. ### Does Mado have an Outline? Yes. Mado builds an Outline from Markdown headings so you can jump through long documents, follow your current section, and keep AI-generated reports or specs navigable. ### Do exported pages include a Table of Contents? Yes. Mado exports can include a generated Table of Contents based on document headings, making the standalone HTML or PDF easier to scan after it leaves the app. ### Can I share Markdown online? Pro includes hosted sharing so you can publish a readable page and send a link instead of another attachment. ### How is Mado different from VS Code? VS Code is a code editor. Mado is a focused Markdown reading environment. It is lighter, quieter, and optimized for consuming documents rather than editing projects. ### How is Mado different from Obsidian? Obsidian is a knowledge management and note-taking system. Mado works with normal Markdown files and focuses on reading, navigation, presentation, and sharing.