plain answers, no jargon

Guides

How to open, read, edit and share the files AI hands you, on a Mac.

FAQ
# Launch plan **Owner:** Maya | step | due | |--------|--------| | beta | Oct 1 |
Start here · Opening filesHow to open a .md file on a Mac (and actually read it)Why a .md file opens as symbols on a Mac, what each built-in app shows you, and how to make every .md file open as a formatted page.9 min read · Updated 28 September 2026
Opening filesWhy .md files open in Xcode or TextEdit, and how to fix itWhy double-clicking a .md file opens Xcode, TextEdit or a random app, and how to choose the app that opens every .md file on your Mac.7 min read Reading betterHow to add color to Mermaid diagramsHow to color Mermaid flowcharts, pie charts and Gantt charts with style, classDef and theme settings, plus a prompt that gets Claude or ChatGPT to do it for you.10 min read Reading betterDyslexia, ADHD and autism: making AI documents easier to readWhat helps dyslexic, ADHD and autistic readers with long AI documents on a Mac, what the research says about OpenDyslexic, and how to tune a page to fit you.12 min read Working with AIHow to edit a .md file without breaking itThe edits that break a .md file (tables, lists, code, frontmatter, bold), how to fix each one, and how to edit safely in TextEdit, VS Code, Typora or a reader.12 min read Sharing and exportingHow to turn a .md file into a PDF on a Mac (and print it)Five ways to turn a .md file into a clean PDF on a Mac, with tables and diagrams intact, plus how to print it so it looks like a normal document.9 min read Sharing and exportingHow to turn a .md file into a Word documentWord can't read Markdown formatting. Here are five ways to turn a .md file into a real .docx on a Mac, and what to do when a Word file comes back.9 min read Working with AIPaste ChatGPT or Claude text into Word without # and starsWhy AI text pastes into Word or Google Docs full of # and ** symbols, and quick fixes for Word, Google Docs, email and Slack, including tables.8 min read Opening filesHow to see .md files formatted in Quick Look on a MacWhy the spacebar preview shows .md files as raw symbols, which Quick Look extensions fix it (free and paid), and how to turn one on.7 min read Reading betterHow to read Mermaid diagrams without reading the codeWhat Mermaid is, how to tell which diagram an AI wrote, how to read flowcharts, timelines and pie charts as text, and how to see them drawn on a Mac.16 min read Reading betterMarkdown tables that are actually readableWhy Markdown tables are so hard to read raw, how to read and edit them without breaking them, and how to get AI tools to write better ones.13 min read Working with AIHow to review a Claude Code plan before approving itWhere Claude Code saves plan files, how to open a plan outside the terminal, and a review workflow with a feedback prompt you can copy.8 min read Working with AIHow to see what your AI changed in a documentFree and paid ways to see exactly what Claude, Codex or another AI changed in a file on your Mac, with or without git, instead of trusting its summary.8 min read Sharing and exportingHow to send a .md file to someone who's never seen oneWhich format to send when you share a .md file (PDF, Word, the .md or a link), what to say with it, and how to keep one version everyone trusts.7 min read Reading betterReading AI documents when you think in picturesWhy raw Markdown is tiring for visual thinkers, what actually helps you read AI output faster, and how to set up your Mac so documents arrive readable.9 min read Markdown explainedWhat is a .md file? A visual reader's guide to MarkdownWhat Markdown is, what every symbol in a .md file means, why AI tools write in it, and how to read and edit it without getting lost.17 min read Opening filesWhere Claude, Cursor and ChatGPT save files on your MacWhere each AI tool puts the files it creates on macOS, what /tmp and ~ mean, and five fast ways to open a file when all you have is a path.18 min read Opening filesWhere does Claude save files on my Mac?Where Claude.ai, the desktop app, Cowork and Claude Code put the files they make, how to open ~/.claude, and what to do when a file is missing.10 min read ComparisonsThe best Markdown readers for Mac, for reading not editingNine ways to read .md files on a Mac, compared honestly: price, who each suits, one real strength and one real limit. Including when to pick something else.11 min read ComparisonsOne Clear Reader vs Marked 3 and Marked 2One Clear Reader compared with Marked 3 and Marked 2 for reading AI files, reviewing plans, editing, exports and price. Including where Marked is the better pick.10 min read ComparisonsOne Clear Reader vs ObsidianHow One Clear Reader and Obsidian differ on a Mac. Obsidian builds a linked library of your notes. One Clear Reader opens any AI document where it landed.11 min read ComparisonsOne Clear Reader vs TyporaAn honest look at One Clear Reader and Typora on a Mac: price, file types, AI file paths, math, editing, Word files, and who each one suits.12 min read ComparisonsOne Clear Reader vs the VS Code Markdown previewWhen VS Code's free Markdown preview is enough, when it isn't, and how it compares to One Clear Reader for reading and reviewing AI documents on a Mac.11 min read Using One Clear ReaderHow do I edit a file in One Clear Reader?Edit Markdown and text files safely in One Clear Reader. The source editor, the visual editor, checking changes before saving, version history and safety guards.7 min read Using One Clear ReaderHow do I save as PDF or Word, or copy with formatting?Turn a document into a PDF, a client PDF with a cover, or a Word file, and copy it as rich text, Markdown, a table or a section link in One Clear Reader.7 min read Using One Clear ReaderHow do I open a file in One Clear Reader?Every way to open a file in One Clear Reader: paste a path, type part of a name, Latest from your AI, the clipboard, the menu bar icon and folders as tabs.8 min read Using One Clear ReaderHow do the trial, license key and updates work?The 30-day Pro trial, what stays free, entering and moving a license key, renewals, refunds and how One Clear Reader checks for updates.7 min read Using One Clear ReaderHow do I make the page easier to read?Reading profiles, Neuro-friendly and Paragraph Focus, themes and colors, text size, zoom, width, Full View and Quiet in One Clear Reader.8 min read Using One Clear ReaderHow do I send notes on a document back to my AI?Leave notes on the exact words in an AI plan or document, copy them as one prompt, share them as a file, and see what changed after the AI edits.7 min read Using One Clear ReaderWhat are the keyboard shortcuts in One Clear Reader?Every keyboard shortcut in One Clear Reader, grouped by task: opening files, reading, review notes, editing, Word files and export. Plus the command palette.7 min read Using One Clear ReaderHow do I read and edit Word files in One Clear Reader?Open .docx files without Word, change the words inside the Word file itself (Pro), or edit a Markdown copy for free. What can change, what stays locked, and backups.7 min read