MinkNote

Product Introduction

1. Definition: MinkNote is a native macOS application (built with Swift/SwiftUI) for note-taking and journaling that operates on a local-first, file-based architecture. It is technically categorized as a Markdown editor and personal knowledge management (PKM) tool.
2. Core Value Proposition: MinkNote exists to provide a private, vendor lock-in-free, and macOS-optimized environment for managing knowledge. Its primary value is data ownership through plain Markdown files, eliminating reliance on proprietary databases or cloud accounts, combined with a native user experience designed for keyboard efficiency.

Main Features

1. Plain Markdown File Foundation: MinkNote does not use a proprietary database. All notes, journals, and projects are stored directly as standard .md (Markdown) files in the user's designated folder hierarchy on the macOS filesystem. This means all content is immediately accessible and editable with any other text editor (e.g., VS Code, Typora, TextEdit) without an export process.
2. Native macOS Integration & Keyboard-First Navigation: As a true native app, MinkNote leverages macOS system frameworks for performance, security (App Sandbox), and UI conventions. Its interface is designed for minimal mouse dependency, featuring comprehensive keyboard shortcuts for navigating between journals, switching notes, focusing the editor, and executing searches, promoting a state of flow for writers and thinkers.
3. Dual-Mode Editor with Rich Text & Markdown: The editor allows users to switch seamlessly between a direct WYSIWYG-style rich text interface and a raw Markdown code view. It includes a live preview option and a contextual formatting toolbar, catering to both users who prefer visual editing and those who work directly with Markdown syntax.
4. Project-Based Organization with Automatic Asset Handling: Notes are structured within Journals, which are contained within Projects—all mirroring standard folders on disk. The app automatically manages embedded assets; when an image is dragged into a note, MinkNote creates an attachments subfolder, stores the image file there, and inserts the correct relative Markdown reference, keeping the file structure clean and portable.
5. Focused, Multi-Scope Search Functionality: MinkNote implements a tiered search system: (1) Quick Search within the current journal, (2) Full Search across the entire open project, and (3) a dedicated Search View for complex, library-wide queries. This allows for precise information retrieval without overwhelming the user interface.

Problems Solved

1. Pain Point: Vendor lock-in and data portability anxiety in note-taking apps. Many applications store notes in closed databases or formats, making it difficult to migrate data or access it outside the app.
2. Pain Point: Inefficient, mouse-dependent workflows that disrupt creative flow and deep work sessions for knowledge workers.
3. Target Audience: Privacy-conscious macOS users (writers, developers, researchers, students) who value data ownership. Users frustrated with Electron-based or web-wrapped apps that feel non-native and consume excessive system resources. Individuals seeking a simpler, more focused alternative to feature-bloated PKM suites.
4. Use Cases: Maintaining a private, future-proof digital journal. Managing research notes for a long-term project where data must remain accessible for years. Writing technical documentation in Markdown that needs to be easily version-controlled with Git. Quickly capturing and organizing ideas without breaking keyboard-centric workflow patterns.

Unique Advantages

1. Differentiation vs. Obsidian: While Obsidian is more feature-rich with a vast plugin ecosystem, MinkNote differentiates through its strictly native macOS implementation, resulting in lower resource usage, deeper system integration, and a UI/UX that adheres consistently to Apple's Human Interface Guidelines. Its philosophy favors curated, built-in functionality over a plugin-dependent architecture.
2. Differentiation vs. Cloud-Based Apps (Notion, Evernote): MinkNote requires no account, has no subscription for core editing, and never sends data to external servers. It solves the problem of privacy, offline reliability, and perpetual cost associated with SaaS note-taking solutions.
3. Key Innovation: The "Grant Access" folder model within the macOS App Sandbox. Instead of requesting broad "Full Disk Access," MinkNote uses the system's secure scoped bookmark API. The user explicitly grants read/write permission to specific folders via the standard macOS Open Panel, minimizing security footprint while maintaining full functionality for user-designated directories.

Frequently Asked Questions (FAQ)

1. Is MinkNote completely free, and what happens after the trial? MinkNote offers a full-featured 14-day free trial. Post-trial, the app transitions to a read-only mode for existing notes, ensuring you never lose access to your data. To continue editing and access Pro features, a one-time license purchase is required. There is no subscription model for core note editing.
2. How does MinkNote handle syncing notes across my Apple devices? MinkNote itself does not include built-in sync. It follows a local-first philosophy. Syncing is achieved by storing your notes folder in a cloud-synced directory like iCloud Drive, Dropbox, or OneDrive. The cloud service then handles file synchronization in the background. MinkNote simply reads and writes to the local files that are synced.
3. Can I use MinkNote with my existing folder of Markdown files? Yes. During setup, you can point MinkNote to any existing folder containing Markdown files. It will read the structure and display your notes within its Projects and Journals interface. The app organizes content based on the existing folder hierarchy on your disk.
4. What are the system requirements for MinkNote on Mac? MinkNote requires macOS 13.0 (Ventura) or later. Being a native SwiftUI app, it is optimized for Apple Silicon (M-series) Macs but runs seamlessly on Intel-based Macs as well, typically offering superior performance and lower memory usage compared to Electron-based alternatives.
5. Does MinkNote support backlinks or graph views like other PKM tools? Not in its current release. MinkNote's initial focus is on core note-taking, organization, search, and a native editing experience. Features like backlinking, graph views, and extensive plugin APIs are common in more mature tools but may be considered for the roadmap after solidifying the core, macOS-native experience.