Skip to content

lunote-code/lunote

Repository files navigation

Lunote

Lunote

Open your Markdown folder—write, link, and explore a knowledge graph. No plugins.
Free, open source, offline. Every note stays a plain .md file on your disk.
Your notes stay on your computer. No account, no upload—sync the folder yourself if you want.

Available for macOS, Windows, and Linux.

GitHub stars latest release platform license

Screenshot  |  About  |  Features  |  Download  |  Development  |  Contribution

Docs: All languages · 简体中文

Translations: 🇨🇳 🇹🇼 🇯🇵 🇰🇷 🇩🇪 🇫🇷 🇪🇸 🇵🇹 🇮🇹 🇷🇺

Guide: Themes · Shortcuts & slash (/) commands · All guides

Typora-style writing + Obsidian-style linking — built in.

Download-macOS Download-Windows Download-Linux

Screenshot · About · Features · Download · Quick start · User guide · FAQ

Lunote — demo: writing, wiki links, knowledge graph, themes

Write · `[[wiki links]]` · backlinks · graph · export · themes


Screenshot

Lunote — first launch

Code editor Source view Knowledge graph
Code editor Source view Knowledge graph
Global search History snapshots Theme settings
Global search History snapshots Theme settings

More theme previews

Extra appearance screenshots live in docs/assets/screenshots/theme/. Ready-to-use CSS, JSON tokens, and snippets: Theme examples.

GitHub Light GitHub Dark IDEA Light IDEA Dark Dim Light
GitHub Light GitHub Dark IDEA Light IDEA Dark Dim Light
Dim Dark Forest Dawn Ember Glow Graphite Noir Lavender Haze
Dim Dark Forest Dawn Ember Glow Graphite Noir Lavender Haze

About

Open a folder of .md files and start writing. Lunote adds [[wiki links]], backlinks, and a graph—no account, no plugin store.

  • Open any folder of .md files as your workspace
  • Visual and source editing with one shortcut to switch modes
  • Built-in wiki links, backlinks, graph, outline, and search
Platforms macOS, Windows, Linux
UI languages English, 简体中文, 繁體中文, 日本語, 한국어, Deutsch, Français, Español, Русский, Português (Brasil), Italiano
Export PDF, Word (DOCX), HTML, PNG · print

Features

Pick your workflow—everything below ships in the app:

Write

For essays, docs, and daily notes—you see formatted text or raw Markdown.

  • Visual editor and Markdown source; Cmd+/ / Ctrl+/ to switch
  • / slash menu for headings, lists, tables, code, Mermaid, callouts, wiki links
  • Tables, math, images, Mermaid, focus mode, Command Palette (Cmd+Shift+P)
  • Code blocks with line numbers, syntax highlighting, language picker, fold, and copy
  • Formatting toolbar (Callout, colors, etc.); hide via File → Preferences → Typography
  • Adjust reading column width, font family, and font size in Preferences → Typography

Link notes

For a second brain: [[links]], backlinks, and a graph without plugins.

  • [[wiki links]] with autocomplete and safe navigation
  • Knowledge panel: backlinks, local graph, embeds, tags, and YAML frontmatter
  • Renaming a note updates [[links]] across the folder

Organize

When the vault grows: tabs, outline, and search across every note.

  • Sidebar file tree, tabs, and global search (Cmd+Shift+F)
  • Per-note outline and external file change detection
  • Save, conflict handling, reveal in file manager

Export & look

Share or print: PDF, Word, HTML—plus themes you control.

  • Export to PDF, HTML, DOCX, PNG; system print
  • Light/dark themes, Theme folder, external CSS
  • Reading column width presets (Narrow / Standard / Wide) for visual mode and preview

History

Try bold edits—snapshots let you preview before saving to disk.

  • Per-note snapshots; restore to the editor without overwriting disk until you save

Download

Download latest release →

No sign-up · local .md files only · works offline

macOS first launch (Gatekeeper)
  1. Move Lunote to Applications
  2. Right-click → Open → Open
  3. If needed, run xattr -cr /Applications/Lunote.app
Platform Package
macOS (Apple Silicon) .dmg (arm64)
Windows (x86_64) .msi (x64)
Windows (ARM64) .msi (arm64)
Linux (Debian/Ubuntu) .deb (+ optional .deb.asc)

Quick start

  1. Download Lunote for your platform.
  2. Open your existing vault—Obsidian, Logseq, Typora, or any folder of .md files. No import step.
  3. Write, type [[ to link notes, use Cmd+Shift+F / Ctrl+Shift+F to search, and export when you need PDF or Word.

Migrating? Your files stay where they are. You can switch back to other tools anytime—they read the same Markdown.


Why Lunote

  • Your files: notes stay as normal .md in folders you control.
  • One app: comfortable writing plus wiki links and a graph—no plugin setup.

How it compares

Already on Typora or Obsidian? Lunote is for people who want comfortable writing and wiki links in one desktop app, without tuning plugins.

Typora Obsidian Lunote
Writing Excellent Good Excellent, built-in
Wiki links & graph Limited Strong (often via plugins) Strong, built-in
Plugins to get started Few Many None

User guide

English how-to guides (themes, shortcuts, and the full / slash command list):


Development

If you wish to build Lunote yourself:

Questions? Open an issue. Pull requests welcome.


Contribution

Before a pull request:

Ideas and migration stories: Discussions · Issues


FAQ

Do I need an account or internet?
No. Lunote works offline. Notes stay local unless you sync the folder yourself (Git, Syncthing, iCloud Drive, etc.).

Can I open my Obsidian or Typora folder?
Yes. Open the folder as your workspace—same .md files, no import.

Can I use Lunote alongside Obsidian?
Yes. Both can point at the same folder. Lunote does not lock your data.

Does it replace Obsidian or Notion entirely?
Not always. Lunote focuses on desktop writing + built-in linking. If you need mobile apps or a large plugin ecosystem, you may still pair other tools.

How do I report bugs or share ideas?
Open an issue or join a discussion—migration stories help others find Lunote.


License

Open-source software. See the repository license file for terms.

Support the project

If Lunote helps you, you can voluntarily sponsor development via TRC20 USDT on the Tron network.

Network Tron (TRC20) · USDT
Address USDT · TEDgPJzSmv7YTjrs2EZrFF5kCNbuZY15iY

Verify the address before sending. On-chain transfers cannot be reversed. Sponsorship is voluntary and does not constitute a purchase of services.