How to Use Joplin: The Beginner's Guide (First Notebook, Markdown Notes, Sync, and the Encryption Key)

CodexFuse Team · 2026-10-30T04:55:02.018Z · 13 min read min read

Learn how to use Joplin: install the free open-source app, write Markdown notes, pick one sync target, turn on end-to-end encryption, and clip the web — step by step.

Joplin is the note-taking app for people who want to own their notes. Learning how to use Joplin comes down to five moves in order: install the free app, create your first notebook, write in Markdown, pick exactly one sync target, and turn on end-to-end encryption before your notes leave your device. Follow that order and your notes will quietly sync across your computer, phone, and tablet with no subscription and no vendor lock-in. Skip the order — especially the sync decision — and you will learn the lesson every experienced Joplin user repeats: the sync target is a one-way door. If you are still weighing the notes lanes, the Obsidian beginner guide covers the linked-notes lane; this guide is the open-source, sync-first lane.

What is Joplin, and who is it for?

Joplin is a free, open-source note-taking and to-do app that stores your notes as plain Markdown files on your own devices and syncs them through a cloud service you choose. It runs on Windows, macOS, Linux, Android, and iOS, with a terminal app for the command-line crowd. Nothing is converted into a proprietary format you cannot leave.

Joplin is for note-takers who care about two things: privacy and portability. If you want your notes searchable on every device but still readable outside any app — in plain files you control — Joplin is built for you. Researchers, students, developers, and anyone burned by a note app that changed its pricing or shut down will feel at home here.

The open-source part is concrete, not a slogan: the source code is public, your notes stay in an open format, and you always have access to them. PCMag named Joplin an Editors' Choice as the best open-source note-taking app, calling it "surprisingly user friendly, even in setting up storage and syncing," while Lifehacker singled out its built-in end-to-end encryption as its best feature (both quotes via the press section of joplinapp.org, fetched 2026-10-30).

How do I use Joplin? The 7-step beginner setup

Here is the whole beginner setup in the order that works. Each step is covered in detail below, so treat this list as the map and the sections below as the territory.

1. Install Joplin on your main computer from joplinapp.org.
2. Create one notebook — call it "Inbox" or "Personal" — and write your first three notes inside it.
3. Learn five Markdown marks: # headings, - bullets, - [ ] checkboxes, [links], and **bold**.
4. Pick your sync target now, before you write more notes. Joplin Cloud is the easiest; Dropbox or OneDrive work if you already pay for one.
5. Run the first sync on this device, then point every other device at the same target.
6. Turn on end-to-end encryption and write the master password down somewhere safe — it cannot be recovered.
7. Install the Web Clipper (Chrome or Firefox) and one plugin that solves a problem you actually have.

That list is the entire first afternoon. Everything below is the detail that keeps you from undoing it later.

How do I install Joplin?

Download Joplin from the official site, joplinapp.org, and run the normal installer for your platform. The desktop and mobile apps are completely free to download and use without limits — you only ever pay if you choose Joplin's own hosted sync. The current stable line is 3.7.x (version 3.7.22, the latest build listed on FileHorse as of late October 2026).

When you first open Joplin, it shows a few welcome notes that tour the main features. Read them. The developers wrote them as the fastest possible orientation, and they double as your first test notes.

On Linux there are several install routes — an install script, Flatpak, or npm — which the Linux setup guides document. On Windows and macOS, the standard installer is the path most beginners should take. If you live in a terminal, there is also an official terminal app you can run from the command line.

How is the Joplin interface organized?

Joplin's window has three panes: your notebooks in the left sidebar, the note list in the middle, and the note editor on the right. You create a notebook, select it, create a note inside it, and start writing — that is the entire mental model. The sidebar can be toggled from the menu if it feels like clutter.

The editor offers three layouts you can switch between: Markdown-only, a split view with your Markdown on the left and the formatted preview on the right, and a Rich Text editor. Beginners who already know Markdown should stay in the split view; beginners who do not can start in Rich Text and switch later. Note that the Rich Text editor has limitations compared to the Markdown editor — do not treat it as the full experience.

Notes can also become to-dos: Joplin has a dedicated to-do note type with checkboxes you can tick off. Tags cut across notebooks, so keep a small notebook hierarchy for stable areas (Work, Personal, Learning) and use tags for states like active or waiting-for-reply, instead of a new notebook for every status.

Do I need to learn Markdown to use Joplin?

No — but five minutes of Markdown pays for itself immediately, because it is how Joplin stores everything. Joplin's official Markdown guide covers the full syntax, and most daily notes need only a handful of marks: # for headings, - for bullets, - [ ] for checkboxes, [text](url) for links, and **double stars** for bold.

The payoff is portability. Because your notes are plain text files, they stay readable in any editor, on any operating system, forever — even if you stop using Joplin tomorrow. The workshop tutorials that teach Joplin in classrooms make this the centerpiece: a checkbox written as - [ ] is text you can read anywhere, not app magic.

Joplin also supports optional Markdown plugins for tables, footnotes, and math, and a Markdown Table Editor plugin exists for heavy table users. Start with the five marks above; add the rest when a real note demands them.

Where do my notes actually live?

Your notes live on your own device first — Joplin is local-first, and sync is a copy, not the home of your data. Notes are stored as plain Markdown files alongside their attachments, which is why exporting is painless: Joplin exports to JEX (its own archive), JSON, raw Markdown, PDF, and more, and it imports JEX, Markdown, raw files, and even Evernote's ENEX format.

This is the quiet superpower most beginners overlook. You can walk away from Joplin any day with your notes intact, which no cloud-locked note app can promise. It is also why the sync decision matters so much: sync copies your plain files around, so you want to choose the copy service deliberately.

How does Joplin sync work?

Joplin syncs by copying your notes to a sync target you choose; every device you point at that same target then stays in step. The supported targets are Joplin Cloud, Dropbox, OneDrive, Nextcloud, any WebDAV server, Amazon S3, or a local filesystem share. You set it under Tools > Options > Synchronization, pick the target, enter the credentials, and press synchronize.

Here is the one-way door: configure the sync target before you create your real notes, run the first full sync on one device, and only then connect your other devices to the same target. Switching targets mid-setup is how notes vanish or duplicate into conflicts — every practical Joplin guide warns about it, and the five-step sync rule from the AnyGen setup guide exists for exactly this reason: one target, credentials, first sync, then device two, never switch mid-stream.

To choose, use this picker:

Most beginners should start with Joplin Cloud for the first month — not because it is mandatory, but because it removes the one variable that causes most beginner grief. You can always migrate later, carefully, one target at a time.

How do I turn on end-to-end encryption?

Encryption is off by default — turn it on under Tools > Options > Encryption, set a strong master password, and Joplin generates a master key from it. From that point, every note is encrypted on your device before upload, using AES-256 with a key derived from your password, so the sync provider — even Joplin itself, if you use Joplin Cloud — cannot read your notes.

Then sync every device once and enter the same master password on each one so the keys propagate. This is step six in the setup order for a reason: enable encryption after the first sync works, not before, so you are debugging one thing at a time.

Two warnings every guide repeats. First, do not lose the master password — encrypted notes cannot be recovered without it, and the password cannot be changed later without re-keying everything. Second, know what E2EE does not cover: it protects notes in transit and at the sync target, but notes stored locally on your device are not encrypted at rest — that is what your operating system's full-disk encryption is for.

How much does Joplin cost?

The apps are free, forever, on every platform — desktop, mobile, and terminal. The only thing that costs money is Joplin's optional hosted sync, Joplin Cloud. Students and teachers get a 50% discount on Joplin Cloud plans.

Prices are listed in euros on joplinapp.org/plans (checked late October 2026):

Notice the strategy behind the tiers: Basic is for text-only note-takers (10 MB per note is plenty for writing), and Pro's real upgrade is the 200 MB per-note ceiling for people who attach scans and PDFs. You never pay for the app, the encryption, or the plugins — only for managed storage and sharing features, like publishing a note to a public URL or sharing a notebook with a collaborator.

For businesses that cannot send notes to any outside server, there is also a self-hosted Joplin Server Business option — you run the sync server on your own infrastructure with your own storage.

How does Joplin compare to Obsidian, Notion, and OneNote?

All four apps take notes; they disagree about who owns them. Joplin is the open-source, sync-first lane: free apps, plain Markdown files, your choice of sync target, built-in E2EE. Here is the honest one-line version of each lane, drawn from our beginner guides:

For a deeper walkthrough of each lane, read our Notion beginner guide (the all-in-one workspace of notes, tasks, databases, and wikis) and the OneNote beginner guide (Microsoft's binder in the cloud, notebooks to sections to pages, autosaved to OneDrive).

How do I save web pages into Joplin?

Install the Web Clipper extension for Chrome or Firefox from the link on joplinapp.org, then clip pages straight into a notebook as notes or screenshots. Researchers use it as a read-later inbox; everyone else uses it for receipts, recipes, and anything they want searchable inside their notes.

Pair the clipper with one habit: clip into a single "Inbox" notebook, then file or delete during a weekly review. Web clips are the fastest-growing pile in any note system, and an unreviewed inbox becomes a junk drawer.

Which Joplin plugins should a beginner install?

Joplin's plugin library lives under Tools > Options > Plugins — browse it like an app store and install only what solves a real annoyance. Three beginner-friendly picks that show up in every setup guide: a Markdown Table Editor for painless tables, a Kanban view for turning to-dos into boards, and Note Tabs for working across several notes at once.

The plugin API also supports custom themes and your own scripts, which is why developers keep extending Joplin — but plugins are dessert, not dinner. Get the seven-step setup working first; customize second.

Sources

• Joplin official site — joplinapp.org (homepage, fetched 2026-10-30): features, platforms, sync services, Web Clipper, E2EE, open source, press quotes.
• Joplin Cloud plans — joplinapp.org/plans (pricing checked late October 2026; prices in euros): tier prices, storage, per-note limits.
• AnyGen Joplin notes showcase — anygen.io/showcase/joplin-notes: notebooks/tags/Markdown system, the five-step sync rule.
• gHacks — ghacks.net: three-pane interface, editor layouts, encryption off by default, export/import formats.
• EngineerHow Joplin setup cheat sheet — engineerhow.com: install steps, sync targets, plugins, keyboard shortcuts.
• Klemet Joplin workshop — klemet.github.io: interface tour, Markdown basics, plugin installation.
• WindowsForum Joplin on Windows — windowsforum.com: sync targets, E2EE setup path, unrecoverable master password.
• Pickuma Joplin review — pickuma.com: AES-256 E2EE details, local notes not encrypted at rest, apps free.
• It's FOSS Joplin tips — itsfoss.com: Tools > Options > Encryption path, "Do not lose this password".
• ToolQuestor Joplin vs Notion — toolquestor.com: plan prices in euros, apps free, pay only for Joplin Cloud.
• FileHorse Joplin download — filehorse.com: latest version 3.7.22 (late October 2026).
• Our beginner guides (fetched 2026-10-30): Obsidian (free, local-first, plain-Markdown vaults, [[ ]] links, paid Sync add-on), Notion (all-in-one workspace of notes, tasks, databases, wikis), OneNote (cloud binder, notebooks to sections to pages, autosaves to OneDrive).

Frequently asked questions

Is Joplin really free?

Yes. The desktop, mobile, and terminal apps are free and open source with no feature limits. You only pay if you choose Joplin Cloud's hosted sync (from €2.99/month); syncing through Dropbox, OneDrive, Nextcloud, or WebDAV costs whatever those services cost you.

What happens if I forget my Joplin encryption password?

Your encrypted synced notes cannot be decrypted — there is no reset and no back door. Joplin's own forum threads treat a forgotten master password as data loss on the encrypted copies. Write the password down before you enable E2EE.

Can Joplin replace Evernote?

It is the most common migration path: Joplin imports Evernote's ENEX export format directly, and its notebooks-plus-tags model maps cleanly onto Evernote's notebooks. The main adjustment is Markdown instead of Evernote's rich-text editor.

Does Joplin work offline?

Completely. Notes live on your device; sync only needs a connection when you want devices to match. The file-system sync target even works with no cloud at all.

Joplin vs Obsidian — which should I choose?

Choose Joplin if cross-device sync (especially to a phone) and built-in encryption matter most; choose Obsidian if linked thinking and a big community plugin scene matter most. Both keep your notes as plain Markdown files, so switching later is painless.