# Shpigford/clearly

Markdown editor for Mac, iOS and iPadOS

Repository: https://github.com/Shpigford/clearly
Canonical: https://ross.abutalabs.com/products/clearly
Homepage: https://clearly.md
Language: Swift
License: NOASSERTION
License Family: other
Topics: macos, markdown, swift
Last push: 2026-08-23T20:58:28+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 12
- inputs: {"age_days": 168, "days_push": 10, "days_rel": 10, "gap_med": 0.0, "n_releases_24m": 49}
- flags: young, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1140, forks 79 (observed 2026-08-28T04:03:44.474726+00:00)

## What it is
Clearly is a free, open-source native Markdown editor for macOS, iOS, and iPadOS built in Swift, with syntax highlighting, GFM preview, KaTeX math, Mermaid diagrams, and PDF export. It has no Electron, subscriptions, or telemetry, and is distributed via the Mac App Store and direct download.

## Use cases
- edit markdown files on mac with syntax highlighting
- preview markdown with mermaid diagrams and katex math
- write markdown notes on iphone
- export markdown to pdf
- preview md files in finder with quicklook
- floating menu-bar scratchpad notes

## When to choose
- you want a native, lightweight markdown editor on Apple devices without Electron
- you need rich preview rendering including math, diagrams, and callouts
- you want a free open-source alternative to subscription markdown apps

## When to avoid
- you need a cross-platform editor on Windows or Linux
- you need collaborative or cloud-sync editing features
- you require a license-approved open-source license for redistribution (license is non-standard)

## Facets
- artifact type: application
- maturity: active
- function: editor, markdown, pdf, documentation
- domain: text-editors, documentation, developer-tools, cross-platform
- platform: -
- tags: markdown-editor, native-app, live-preview, katex, mermaid, syntax-highlighting, quicklook, no-electron, macos, ios, swift

## Member repositories
- Shpigford/clearly (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:44.474726+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:35:26.577354+00:00, confidence not recorded.
  - readme: https://github.com/Shpigford/clearly (fetched 2026-08-28T04:03:44.474726+00:00, sha f71859927f3b)
  - homepage: https://clearly.md (fetched 2026-08-29T12:40:33.854989+00:00, sha 9370276f72d3)
  - site_page: https://clearly.md/changelog (fetched 2026-08-29T12:40:33.863852+00:00, sha c034ae6c45f9)
- Data as of 2026-08-30T08:39:29.467469+00:00.