markra  by murongg

Local-first Markdown editor with native AI writing assistance

Created 3 weeks ago

New!

285 stars

Top 91.8% on SourcePulse

GitHubView on GitHub
Project Summary

A WYSIWYG Markdown editor with native AI, Markra offers a local-first, open-source solution for writers and developers. It prioritizes user privacy by keeping all data on disk and allowing AI processing only where configured, making it ideal for those seeking a powerful, self-contained writing environment.

How It Works

Markra operates on a local-first principle, managing files and workspace data directly on the user's machine without cloud synchronization. It provides a dual-mode editing experience, supporting both WYSIWYG (What You See Is What You Get) and raw Markdown source views. AI functionalities are integrated locally, allowing users to polish, rewrite, or expand content with previews before committing changes. The architecture supports multi-provider AI configurations, including local models and various cloud endpoints.

Quick Start & Requirements

Download the latest desktop builds from GitHub Releases for macOS (Apple Silicon/Intel), Windows (installer/portable), or Linux (AppImage). Configure AI providers within the application's settings to enable AI assistance.

Highlighted Details

  • WYSIWYG Markdown: Renders links, images, HTML, KaTeX math, Mermaid diagrams, and GFM tables inline, with the ability to revert to source view. Features block-level editing via slash commands and drag handles.
  • Native AI Integration: Offers inline AI for selected text and a side panel for document-wide tasks like polishing, rewriting, summarizing, and translation. All AI edits are previewed before application.
  • Multi-Provider AI Support: Connects to various AI services including OpenAI, Anthropic, Google Gemini, Mistral, Ollama, and any OpenAI-compatible endpoint. Integrates web search via Bing or SearXNG.
  • Local Workspace: Manages single files or entire folders, supporting file tree browsing, creation, renaming, deletion, document tabs, outline navigation, and double-bracket link completion.
  • Export Options: Exports documents to standalone HTML or PDF with configurable page layout and metadata.

Maintenance & Community

Contributions are welcomed through GitHub issues and discussions. Specific details regarding core maintainers, sponsorships, or dedicated community channels (e.g., Discord/Slack) are not detailed in the README.

Licensing & Compatibility

Markra is licensed under the AGPL-3.0 license. This strong copyleft license requires derivative works to be distributed under the same license, potentially impacting compatibility with closed-source commercial applications.

Limitations & Caveats

The project roadmap indicates ongoing development for improved workspace stability, more intelligent AI edit previews, full-text search capabilities, and enhanced export/sharing features, suggesting these areas are still maturing.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
82
Issues (30d)
56
Star History
290 stars in the last 23 days

Explore Similar Projects

Feedback? Help us improve.