Markly

Product Introduction

1. Definition: Markly is a native, open-source Markdown editor application for macOS, built using SwiftUI and AppKit. It operates as a file-system-first editor, directly interfacing with .md files in user-designated folders.
2. Core Value Proposition: Markly exists to provide a fast, native, and non-destructive editing experience for Markdown notes and documentation. Its core value is eliminating vendor lock-in by avoiding proprietary databases or import processes, ensuring user notes remain as portable plain text files.

Main Features

1. Live-Rendering WYSIWYG Editor: Markly renders Markdown formatting (headings, bold, italic, code blocks, tables, KaTeX math) in real-time as you type. It uses Apple's TextKit for incremental syntax highlighting, maintaining performance on long documents. Formatting markers are hidden on lines not being actively edited to reduce visual noise.
2. Contextual Liquid Glass Format Bar: Upon text selection, a translucent formatting toolbar appears. It visually indicates active formatting styles (e.g., bold, highlight) and allows toggling them. This feature is implemented using Apple's Liquid Glass visual effects for a native macOS aesthetic.
3. Integrated Git Sync Workflow: A dedicated sidebar component displays Git branch status and change counts scoped to the notes folder. A one-click button executes a commit, pull (with rebase), and push sequence. It can also initialize a new Git repository, catering to developers and technical writers.
4. Bi-Directional Scroll-Synced Preview Pane: A separate preview pane renders Markdown using a GitHub-flavored style with integrated KaTeX for mathematical notation and syntax highlighting. The preview scrolls in synchronization with the editor cursor, and vice-versa, enabling precise live preview.
5. Focus Mode with Typewriter Scrolling: Activating Focus Mode dims all content except the current paragraph. Typewriter scrolling dynamically centers the active line of text, enhancing concentration during long-form writing sessions.

Problems Solved

1. Pain Point: It solves the problem of Markdown editor bloat, cloud dependency, and data lock-in. Many editors require importing files into a proprietary library or database, making notes difficult to access or migrate.
2. Target Audience: The primary user personas are macOS-based software developers, technical writers, researchers, and knowledge workers who value data ownership, use Git for version control, and prefer a keyboard-centric, native application experience over Electron-based tools.
3. Use Cases: Essential scenarios include: maintaining a developer knowledge base in a project repository; writing technical documentation alongside code; managing personal notes in iCloud/Dropbox-synced folders with version history via Git; and drafting content requiring mathematical notation with live KaTeX preview.

Unique Advantages

1. Differentiation: Unlike cloud-first note apps (Notion, Evernote) or many Markdown editors, Markly has no accounts, analytics, or tracking. Unlike other native apps, it deeply integrates folder-based Git operations. Compared to Electron apps (like Obsidian or VS Code), it offers superior performance and system integration via native SwiftUI/AppKit.
2. Key Innovation: Its "Git Sync" is intelligently scoped to the user's notes folder, committing only relevant .md file changes even within a larger code repository. This prevents polluting commit history with unrelated project files, a nuanced solution for developer workflows.

Frequently Asked Questions (FAQ)

1. Is Markly really free and open source? Yes, Markly is completely free (gratis) and its source code is released under the permissive MIT license, allowing inspection, modification, and distribution.
2. How does Markly handle data privacy and security? Markly enforces a strict Content Security Policy (CSP), allows disabling remote images and CDN scripts in the preview, and performs no telemetry or analytics. Notes are only saved to your local file system.
3. Can I use Markly with existing folders and Git repositories? Absolutely. You point Markly at any folder on your Mac. It will instantly display and allow editing of all .md files within. If the folder is a Git repository, the sync sidebar will detect and manage it.
4. What are the system requirements for Markly? Markly requires macOS 26 (Tahoe) or later and runs on both Apple silicon and Intel-based Macs. It is distributed as a signed DMG with automatic update capabilities.
5. How does Markly compare to Typora or iA Writer? Markly shares the live-preview philosophy of Typora but is native (not Electron) and open source. Compared to iA Writer, it offers more advanced features like integrated Git sync, scroll-synced preview with math, and a focus on folder-based, non-library management.