{"id":51676437,"url":"https://github.com/jasonmimick/markmore","last_synced_at":"2026-07-15T06:34:30.945Z","repository":{"id":371411306,"uuid":"1299972018","full_name":"jasonmimick/markmore","owner":"jasonmimick","description":"Markdown, beautifully rendered — straight from your terminal. Native macOS previewer: GitHub styling, live reload, mermaid, file tree, hex view.","archived":false,"fork":false,"pushed_at":"2026-07-15T02:37:46.000Z","size":24715,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-15T06:34:26.639Z","etag":null,"topics":["cli","macos","markdown","markdown-viewer","mermaid","previewer","swift"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jasonmimick.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-07-14T03:38:02.000Z","updated_at":"2026-07-15T02:37:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jasonmimick/markmore","commit_stats":null,"previous_names":["jasonmimick/moremark","jasonmimick/markmore"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/jasonmimick/markmore","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasonmimick%2Fmarkmore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasonmimick%2Fmarkmore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasonmimick%2Fmarkmore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasonmimick%2Fmarkmore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jasonmimick","download_url":"https://codeload.github.com/jasonmimick/markmore/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jasonmimick%2Fmarkmore/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35494971,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-15T02:00:06.706Z","response_time":131,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","macos","markdown","markdown-viewer","mermaid","previewer","swift"],"created_at":"2026-07-15T06:34:25.564Z","updated_at":"2026-07-15T06:34:30.937Z","avatar_url":"https://github.com/jasonmimick.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"icon.svg\" width=\"128\" alt=\"markmore icon\"\u003e\u003c/p\u003e\n\n# markmore\n\n**Markdown, beautifully rendered — straight from your terminal.**\n\n`markmore README.md` opens a native macOS window with your markdown the way it's meant to look — GitHub styling, syntax-highlighted code, mermaid diagrams, live reload.\n\n```sh\nmarkmore README.md        # renders RIGHT HERE in your terminal (default)\nmarkmore                  # current folder — README or an index\nmarkmore -w README.md     # open the native window instead\ngit log | markmore        # preview stdin\nmarkmore --snap file.md   # terminal render as one full-fidelity image\n```\n\n**In the terminal** (the default): styled, wrapped, selectable text — and in kitty, ghostty, WezTerm, or iTerm2, block math, mermaid diagrams, and images appear *inline as real typeset graphics* on a transparent background. Links are clickable (OSC 8). In plain terminals you still get clean ANSI text.\n\n**In the window** (`-w`): live reload, file tree, history tabs, table of contents, find, zoom, typography presets, hex view, print-to-PDF. The window detaches — your prompt comes right back.\n\n## Features\n\n- **Live reload** — re-renders on save (handles editors' atomic saves), keeps your scroll position\n- **Real GitHub rendering** — [github-markdown-css](https://github.com/sindresorhus/github-markdown-css) + [highlight.js](https://highlightjs.org) GitHub themes; follows system light/dark with a View-menu override\n- **Math** — `$inline$` and `$$display$$` typeset with [KaTeX](https://katex.org), fully offline. Try [samples/math.md](samples/math.md).\n- **Typography that cares** — View ▸ Typography presets (Book, Classic, Mono) or the native font panel (`⌘T`); hyphenation, ligatures, and `⌘P` prints a properly typeset PDF\n- **Mermaid** — ```` ```mermaid ```` fences render as diagrams, theme-aware\n- **Browse a repo's docs** — relative `.md` and folder links open in-window; `⌘[` back, `⌘]` forward; history tabs appear at your second doc; `⌘⇧T` floats a table of contents\n- **Native file tree** — `⌘B`: real disclosure triangles, Finder icons, live-refreshes as files change, root folder on top. Off by default. We are not Obsidian — nothing is ever written into your folders.\n- **Opens anything** — source files render syntax-highlighted, images render as images, and binaries get a classic `hexdump -C` view (`⌘⇧H` forces hex on any file). Try it on [samples/magic.bin](samples/magic.bin).\n- **Find** (`⌘F`), **zoom** (`⌘=`/`⌘-`), word count + reading time in the titlebar, YAML front matter as a tidy collapsible block\n- Everything vendored into a single self-contained binary — works offline, no runtime dependencies\n\n`⌘W` close · `⌘Q` quit · `⌘R` reload · `⌘?` full reference in-app\n\n## Install\n\n```sh\nbrew install jasonmimick/markmore/markmore\n```\n\nBuilds from source on your Mac with `swiftc` (ships with Xcode Command Line Tools) — no Gatekeeper warnings, nothing unsigned downloaded.\n\nOr from a clone:\n\n```sh\n./build.sh   # installs markmore.app to ~/Applications + wrapper to ~/.local/bin\n```\n\n## Using an AI coding agent?\n\nmarkmore ships as a skill for the major agent CLIs — your agent learns to offer rendered previews of the markdown it writes:\n\n- **Claude Code**: `/plugin marketplace add jasonmimick/markmore` then `/plugin install markmore@markmore`\n- **Codex CLI** (and other `.agents/skills` agents): the skill is bundled in this repo at `.agents/skills/markmore/`\n- **Kiro**: add this repo as a Power (`POWER.md` included)\n\n## Why\n\nEvery markdown previewer is either $14, an Electron app, a terminal approximation, or trapped inside an editor. This one is a command: type it, see the document, hit `Cmd+W`, back to work.\n\n## Credits\n\n- [marked](https://github.com/markedjs/marked), [github-markdown-css](https://github.com/sindresorhus/github-markdown-css), [highlight.js](https://github.com/highlightjs/highlight.js), [mermaid](https://github.com/mermaid-js/mermaid) — vendored at build time\n- Icon based on the [Markdown Mark](https://github.com/dcurtis/markdown-mark) (CC0) by Dustin Curtis\n\nMIT © Jason Mimick\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasonmimick%2Fmarkmore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjasonmimick%2Fmarkmore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasonmimick%2Fmarkmore/lists"}