whatisgithub

What is markmark?

easychen/markmark — explained in plain English

Analysis updated 2026-05-18

85SwiftAudience · writerComplexity · 1/5LicenseSetup · easy

In one sentence

A macOS Markdown reader that lets you annotate text as you read and copy your notes to an AI chat in one click to get revisions.

Mindmap

mindmap
  root((MarkMark))
    What it does
      Renders Markdown files
      Lets you annotate with CriticMarkup
      Copies annotated text for AI
    Tech stack
      Swift
      WKWebView
      cmark-gfm
      KaTeX
    Use cases
      Review AI-generated documents
      Annotate and request AI revisions
      Read Markdown with diagrams and math
    Audience
      Writers reviewing AI content
      Developers reading docs
      macOS users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Read an AI-generated Markdown document and mark up the parts you want changed.

USE CASE 2

Copy an annotated document with a guiding prompt to paste into any AI chat for revision.

USE CASE 3

Browse a folder of Markdown files with a file tree and heading outline.

USE CASE 4

Export a rendered Markdown document, including diagrams and math, as a PDF.

What is it built with?

SwiftWKWebViewcmark-gfmKaTeXPrism.js

How does it compare?

easychen/markmarkjoeseesun/qmprompteroomol-lab/lockime
Stars858789
LanguageSwiftSwiftSwift
Setup difficultyeasymoderateeasy
Complexity1/53/51/5
Audiencewritergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires macOS 15.0 or later, building from source requires Swift and the included build scripts.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

MarkMark is a native macOS app for reading Markdown files, with a built-in workflow for annotating text and sending your notes to an AI for revision. Markdown is a plain-text format commonly used for documentation, notes, and content generated by AI tools. MarkMark renders those files so they look formatted, rather than showing the raw symbols. The app uses a three-pane layout: a file tree on the left, the rendered document in the middle, and an outline of headings on the right. You can open folders and browse files with keyboard navigation, open multiple files in separate windows, export to PDF, and switch between 33 visual themes. The main feature that sets it apart from a standard reader is annotation support using a format called CriticMarkup. While reading a rendered document, you can select any text and mark it for deletion, replacement, commenting, or highlighting. The annotations appear visually in the document, with deletions shown as red strikethrough and insertions in green, so you can see your feedback at a glance while reading. A single button in the title bar copies the full document with all annotations attached, plus a guiding prompt, ready to paste into any AI chat. The intended flow is: an AI produces a Markdown document, you open it in MarkMark, annotate the parts you want changed, copy everything, paste it back into the AI, and the AI revises based on your specific notes. Annotations use a plain-text standard, so they are portable and not tied to this app. A single click also removes all annotations and restores the original text. The app renders diagrams in Mermaid and PlantUML formats, supports math formulas through KaTeX, and highlights code blocks in more than 30 programming languages. It runs on macOS 15 and later, as a universal binary that works on both Intel and Apple Silicon Macs. The project is forked from an earlier Markdown reader and adds the annotation and AI-handoff workflow on top. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me build and run MarkMark from source using swift build.
Prompt 2
Explain how to use CriticMarkup annotations in MarkMark to mark text for deletion or replacement.
Prompt 3
Show me the keyboard shortcut to copy an annotated document for AI in MarkMark.
Prompt 4
Walk me through packaging a signed and notarized MarkMark DMG for distribution.

Frequently asked questions

What is markmark?

A macOS Markdown reader that lets you annotate text as you read and copy your notes to an AI chat in one click to get revisions.

What language is markmark written in?

Mainly Swift. The stack also includes Swift, WKWebView, cmark-gfm.

What license does markmark use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is markmark to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is markmark for?

Mainly writer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.