Getting your notes into Obsidian
How does it work — what do I do on the tablet?
Tag it. On the tablet you put a tag — “sync”, or whatever you like — on a notebook, a PDF, a page or a whole folder. In Obsidian you map that tag to a vault folder once, then run Sync now.
You need Obsidian 1.5.7 or later on desktop, and a reMarkable account with cloud sync on — or the direct connection to your tablet, which needs no account. Only a mapped tag is fetched; everything else on the device is left alone.
How it works →
Can I sync only some notebooks, or does everything come over?
Only what you tag. A notebook, a single page or a PDF with a mapped tag syncs; anything untagged is never fetched. Tagging a folder passes the tag to everything inside it, including folders nested below — which is convenient and can be a lot at once, so look at how much sits under a folder before you tag it.
An unmapped tag is not lost, it is simply not selected. You can change or remove a mapping at any time.
Does it sync automatically?
It can, but it is off until you turn it on. Under Automatic sync you can start a sync when Obsidian launches, and add an interval while it stays open. A manual sync pushes the next automatic one back rather than running twice for nothing.
Handwriting to text
Does it convert my handwriting to text?
Yes. A synced page arrives with the page render from your tablet and a text transcript below it, so you can search and link your notes in Obsidian. On macOS this works with no setup at all.
On Windows and Linux you point the plugin at a local server you run — Ollama or LM Studio — so the text is made on your own machine either way. Transcription is free: no account, no API key. Like any handwriting recognition it misreads sometimes, so check anything that matters against the page.
How transcription works →
Against the tablet’s own conversion, in full →
How accurate is the transcription?
Good enough to search and link your notes, not good enough to trust blindly. It depends on your handwriting and on which backend you use: Apple Vision reads cursive well but returns flat text, with no headings or lists; a local model keeps that structure and reads more accurately.
They fail differently, too. Vision’s mistakes usually look broken on the page, while a model writes its mistakes as fluent, plausible text — which is harder to spot. Check anything that matters against the handwriting, which the note embeds right above the transcript.
The measured error rates, page by page →
Can I run the handwriting recognition on my own machine?
Yes, and that is the default. Three backends read your handwriting locally, with no account and no API key: Apple Vision on macOS 13 or later, which needs no setup; any local AI server you run yourself, such as Ollama or LM Studio, which works on every platform; and an optional managed local model that the plugin downloads for you, where your machine qualifies.
Each page is written to your system temp directory as a temporary image while it is read, and deleted straight after.
Transcription backends →
The three local backends, in full →
Can I use my own model or an AI service for it?
Yes. You name the model yourself on every backend except Apple Vision — the field starts empty and the plugin suggests nothing, because a model id baked into a plugin goes stale the day its provider retires it. A local server you run takes any vision model you have loaded.
Cloud services — Anthropic, OpenAI, Google, OpenRouter — are part of the paid add-on and run on your own API key; they are off unless you turn them on.
Can I re-run the text recognition on notes I already synced?
Yes — either all of them or just one. Re-transcribe all synced notes fetches every notebook again; Re-transcribe this note re-reads only the note you have open, so repairing one bad transcript no longer costs a whole-vault run. Both rewrite only the transcript, leaving the embedded render and anything you wrote yourself untouched.
This is also how you fill in a transcript that never arrived — a note synced before a backend was set up keeps its render and no text, and nothing refills it on its own.
Re-transcribing one note, or all of them →
Without the cloud, and privacy
Does my handwriting leave my machine?
Not with the default settings. Rendering and transcription run on your own computer, and the three local backends send nothing anywhere.
Four things do use the network, and each is named: transcription through a cloud service, which is part of the paid add-on, uses your own API key and sends the page image to that provider — you choose it, and it is off unless you turn it on; the licence check contacts polar.sh at most once every 7 days, carrying your key and nothing about your notes, and never for anyone who has not bought or started a trial; starting the trial sends taggedsync.com a 12-character hash of this vault’s Obsidian id, once, when you press the button, and nothing else; and the optional local model is downloaded once, if you opt in.
There is no telemetry of any kind.
Privacy and permissions →
Can I use it offline, or in an air-gapped setup?
Yes, if you sync straight from the tablet and transcribe locally. That combination needs no internet at all: the plugin talks to your reMarkable over USB or your own Wi-Fi, and the transcript is made on your machine.
Two things want a connection, and neither for long. Starting the free trial needs one, once, for the click that issues it. The licence check is forgiving — the last valid answer carries for 30 days, after which settings says so and Pro keeps working. Silence never locks the plugin.
Privacy →
PDFs, books, and typed text
Can I get my PDF highlights into Obsidian?
Yes. A marked-up PDF arrives with a digest in place of a transcript: every passage you highlighted, underlined or circled, quoted with the sentence around it and filed under the section it came from, each with a link back to its page. The pen counts as much as the highlighter, the Paper Pro’s shader included.
The words come from the PDF’s own text, not from a picture of it, so no marked word can come out misspelled and this works the same on every platform. Each quote gets a block ID, so you can embed a single passage anywhere.
Annotated PDFs →
PDF highlights, in full →
Are my handwritten margin notes exported as text?
Yes, once you switch them on under Settings → Handwritten notes. They are off by default, because transcribing them is work your machine does per note and it needs a transcription backend. Each note is printed where you wrote it — under the section heading it sits in, or beside the sentence it points at — with a link to its page.
You can also press the eye in the corner of an entry to see the strip of page it was written on. That image is drawn on demand and never written into your vault.
Can I get my EPUB highlights into Obsidian?
Yes. A reMarkable has no EPUB reader — it converts the book to a PDF on the tablet and shows you that — and the plugin reads the same PDF. So a highlight in a book arrives as the quote it is, under the chapter it sits in, named the way the book’s own table of contents names it.
Why did my EPUB highlights move after I changed the font or margins?
Because the tablet laid the book out again. Changing a book’s font, its size or its margins makes the reMarkable rebuild the PDF it shows you. Measured on a real tablet: every mark survived that, and each kept its exact position while the text moved out from under it — so a highlight that covered one sentence now covers a different one.
The plugin mirrors what the device holds, so it cannot put them back. What it does is tell you: a book whose page count has changed is reported after the sync. Settle the font before you start annotating.
What happens to typed text from the Type Folio?
It is taken from the file exactly as you typed it and never transcribed, so no typed word can come out misspelled. Where it lands depends on the backend: Apple Vision knows where each line sits, so your typed text stays in place among the handwriting around it; other backends add it at the end of its page.
A typed page that reads like a document — an article you sent over, prose you wrote — is treated like a PDF instead: what you mark on it arrives as a digest, and that needs no transcription at all. Only that page — the handwritten pages of the same notebook keep their transcript.
Zotero
Does it work with Zotero?
Yes, since 1.8.0. Send a PDF from your Zotero library to the tablet, mark it up, sync: the note knows which paper it is and links to the Zotero item and your web library. With Pro, what you marked lands in Zotero as native highlights, underlines and comments. Needs a zotero.org API key; the desktop app is optional.
A note already in your vault can be aimed at an item by hand, with the command Link to Zotero item…. Switch frontmatter properties on and it also carries zotero-key and, where the item has one, citekey — the names other Zotero tools in Obsidian already read.
Zotero →
Zotero and your reMarkable, in full →
How does a paper get from Zotero onto my tablet?
Two commands in Obsidian. Send Zotero PDF to reMarkable… finds one paper by title, author or year. Send tagged Zotero papers to reMarkable sends every paper you tagged to-remarkable in Zotero, in one go. The PDF lands in a Zotero folder, untagged; you give it your sync tag on the tablet when you want it back. Nothing is written into Zotero.
Zotero to reMarkable, step by step →
Does that break “never writes to my tablet”?
No. Sync never writes to your tablet; that has not changed. Send puts a PDF on it only when you run one of those two commands, and only adds. It never changes, deletes, moves or renames anything, and no automatic sync ever sends.
Do I need the Zotero desktop app?
No. The free half works with zotero.org and an API key. The desktop app (Zotero 10, local API on) is the Pro connection: the plugin then reads and writes on your machine, and your marks reach Zotero without a zotero.org round trip.
Each connection is its own switch under Settings → Zotero. Turn Use zotero.org off and nothing Zotero-related leaves this machine, whatever key is stored. With both on, the desktop app is asked first and zotero.org catches the papers it has no copy of.
Do my highlights end up in Zotero?
With Pro, yes: highlights, underlines and margin notes as native annotations, in the colour you used; your edits in Zotero win. Without Pro they stay in the vault, and the note says so. Group libraries are Pro too, each switched on by name.
Which highlight colours reach Zotero?
The colour you used, matched to one of Zotero’s own eight by hue rather than by the nearest value — so a pastel green stays green instead of turning grey. How many you have to work with is the device’s doing: a reMarkable 2 records three, a Paper Pro six with its highlighter.
The digest in your vault names those same colours, so one mark reads the same in both places. Recolouring in Zotero afterwards is safe — from then on your version of that colour wins.
Colours →
What if Zotero cannot be reached?
The sync finishes anyway. Your vault is written first, so a Zotero problem costs the Zotero half of one note and nothing more. That note’s top line names what went wrong: nothing answered, the key has no write access, a rate limit was hit, the item has been deleted.
The next sync tries again, and nothing needs cleaning up first: write-back only adds, refreshes and trashes, and each of those is safe to repeat. Whatever already arrived is not written a second time.
When something does not reach Zotero →
Where does the Zotero side not work?
In four places. It wants Zotero 10, because the desktop connection speaks an API only that version has. Only PDF attachments travel, so an EPUB item stays where it is. Ink never leaves your machine: a margin note arrives as the text it was transcribed into. And an item holding two PDFs waits for the command that asks which.
Erasing a highlight on the tablet moves it to Zotero’s trash at the next sync — unless you had edited that annotation in Zotero, in which case your version stays.
How syncing behaves
What does a synced note look like in my vault?
It is a Markdown note with the rendered pages embedded at the top. Below them, a handwritten notebook gets the highlights you made on the tablet, then a transcript split by page, so a long notebook stays navigable — each page heading links into that page of the render.
A marked-up PDF or EPUB gets a digest of your marks instead; a notebook with a page of typed prose in it gets both — the digest above, the transcript of the pages you wrote by hand below. If transcription is off or finds nothing, the note is still written with the render; that is never lost. There is no frontmatter unless you ask for it.
What gets synced →
Will it overwrite notes I edited myself?
No. A synced note belongs to the plugin and every sync rewrites it — but if you have edited one, the plugin notices, refuses to touch it, and tells you how many notes it skipped. That note stops updating until you undo your change.
Every synced note says all this at the top, in a collapsed callout. Keep your own writing in a note of your own and link to the synced one.
Can I stop syncing a notebook — and what happens to the note?
Remove the tag on the tablet, or the mapping in settings, and it stops being updated. The note itself is never deleted — it stays exactly where it is, with everything already in it.
A note you have moved somewhere else in your vault also stays where you put it and is updated there; only changing the tag’s folder in settings moves notes, and then only the ones still in the old folder.
Can my vault mirror the folder structure on my tablet?
No. Routing is by tag: one reMarkable tag goes to one vault folder, and everything with that tag lands there, whatever folder it sits in on the device. Tagging a folder on the tablet passes its tag to everything inside, but the shape of that folder is not rebuilt in your vault.
If you want the device’s folder in your notes, the Pro frontmatter properties carry it as remarkable-folder, which you can group or filter by.
Limits, comparison, and help
Can it write anything back to my tablet? Can it mess up my reMarkable?
No. The sync runs one way only, reMarkable to Obsidian, and nothing is ever written back to your tablet — not a note, not a tag, not a deletion. Through the cloud, the plugin’s access is read-only. If you use the direct connection, it reads over SSH and writes exactly one thing, during pairing: a public key for your vault.
It also offers to switch on Wi-Fi access, and only if you say yes.
Since 1.8.0 there is one exception you run yourself: Send puts a Zotero PDF on the tablet, and only adds. See Zotero.
Zotero →
What can’t it do?
It does not sync back to your tablet (Send adds a Zotero PDF when you ask; nothing else goes up), and it does not pull from Google Drive or Dropbox — your notes come from the reMarkable cloud or from the tablet itself. It does not extract tasks or build an index across documents.
A scanned PDF without a text layer gives much less: highlights arrive as the words your tablet recorded, and pen marks are not recognised at all. Tables come out as plain lines. A page you scrolled far past the screen arrives as a complete image, but only its top three screen-heights are transcribed.
Limitations →
It is not syncing — what do I do?
Open the plugin settings and press Copy diagnostics — it collects your plugin and Obsidian versions, your platform, the backend you selected and the last error, and puts them on your clipboard. Nothing is sent anywhere by pressing it. Then open an issue on GitHub and paste it in. I read every issue. If your report contains anything private, email it instead.
Reporting a problem →