Obsidian Note Sync watches one or more folders of Markdown notes and turns them into a single, continuously-updated PDF on your reMarkable. It is designed for Obsidian users, but works with any folder of Markdown files.
The resulting document has a table of contents, folder navigation, clickable links between notes, and keeps any handwriting you add to it - even as the notes update.
This feature requires a Klass-RM Uploader Pro license. It is Mac-only.
A reMarkable Connect subscription is not required. The output is a PDF, not a server-converted Notebook.
Uses the same device pairing as Calendar Planner Sync. If you have already set up a calendar planner, you are ready to go.
What it generates
When you sync a note collection, the app generates a PDF with:
- Title page - the collection name and optional cover image.
- Hierarchical folder index - mirrors your vault's folder structure. Each folder has its own index page listing its subfolders and notes, with an Up link back to the parent.
- Each note on its own page(s) - frontmatter shown as a table, then the rendered Markdown below. Every note page has an Up link back to its folder's index.
- Clickable wikilinks -
[[note name]]links in your notes become working links in the PDF, jumping to that note's page. Aliased links ([[note|alias]]) and folder paths ([[folder/note]]) are supported. - Clickable external links -
https://URLs in your notes are clickable in the PDF.
Setting up a note collection
- Go to the Note Sync tab in Klass-RM Uploader.
- Click + to add a new note collection.
- Give it a name (appears on the title page and in your reMarkable library).
- Click Add Folder and choose one or more folders to include. The app reads notes recursively from everything inside.
- Configure your settings (see below).
- Click Create.
- The app reads your notes, builds the PDF, and uploads it to your reMarkable.
Note collection settings
Folders
You can add multiple folders to one collection. All their notes are combined into a single document. If the same note exists in two folders, both versions are included.
Tag filter
To include only certain notes, enter one or more tags in the tag filter. The app includes notes that have any of those tags in their frontmatter (tags: field) or as inline #tags in the text.
Leave the filter empty to include all notes in the selected folders.
Device
Choose your reMarkable model. This sets the PDF page size:
- reMarkable 2 / reMarkable Pure
- reMarkable Paper Pro
- reMarkable Paper Pro Move
Font and text size
- Font: Avenir, Baskerville, Figtree, OpenDyslexic, or American Typewriter.
- Text size: Small, Medium, or Large.
Toolbar position
Adds a navigation strip along one edge of every page (None, Top, Left, or Right). Reserves that edge so content does not overlap with it.
Handedness
Left or Right. Reserves the corner on your writing hand.
Cover image
Optionally set a background photo for the title page, auto-downsampled for the reMarkable screen.
Folder list style
Controls how notes are listed in the folder index pages:
- Title rows (default): Each note is a single line showing just the note title.
- Summary cards: Each note is shown as a card with its title, a date, and a short excerpt or summary. Subfolders appear as tinted bordered chips.
When using summary cards, you can also configure:
- Summary field: The name of a frontmatter field to use as the excerpt. Falls back to the first few lines of the note body if the field is absent.
- Date field: The name of a frontmatter field to use as the date. Falls back to the file's last-modified date.
- Excerpt length: How many lines of text to show in each card (2, 3, or 4).
Refresh interval
How often the app re-scans your folders while it is open and re-syncs if anything changed:
- Off (manual only)
- Every 30 minutes
- Every hour
- Every 3 hours
- Every 6 hours
- Every 12 hours
- Daily
You can also trigger a sync manually at any time with the Sync Now button.
Note ordering
Notes are listed alphabetically by note name within each folder. Folders come before individual notes in each index.
How syncing works
When a sync runs (automatically or manually):
- The app scans all watched folders for notes.
- If the tag filter is set, notes without matching tags are excluded.
- The app checks whether anything has changed since the last sync (by comparing file sizes, paths, and modification times). If nothing changed and the settings are the same, the sync completes immediately without regenerating.
- If changes are found, the PDF is regenerated.
- The updated PDF is pushed to your reMarkable, updating only the pages that changed. Pages that did not change are left alone.
Your handwriting is preserved. Ink you add to a note's page stays there across syncs, as long as the note's page count does not change. If you edit a note so it becomes longer or shorter and it spans a different number of pages, the ink on those pages may shift. For stable, shorter notes this is rarely an issue.
Clickable wikilinks
Obsidian wikilinks in your notes become working links in the PDF. Supported formats:
[[Note Name]]- links to that note's first page.[[Note Name|Display Text]]- same, with custom link text.[[folder/Note Name]]- links to a note in a subfolder.[[Note Name#heading]]- links to the note's first page (heading targeting is not yet supported).
If the linked note is not in the collection (because it is in an excluded folder or filtered out by tags), the link text appears as plain text instead of a working link.
Removing a note collection
- Go to the Note Sync tab.
- Click the collection.
- Click Remove.
This stops syncing. The PDF remains on your reMarkable.
Troubleshooting
The sync is not picking up my changes:
- Make sure Klass-RM Uploader is open.
- Check the refresh interval setting. If it is set to Off, syncing is manual only - click Sync Now.
- Check that your folders are still accessible. If you moved or renamed them, re-add them in the collection settings.
Wikilinks are not working:
- The linked note must be in one of the collection's watched folders and must not be excluded by the tag filter.
- Check the note name exactly matches the link (case-insensitive, but the name must be correct).
My handwriting shifted:
- This happens when a note's length changed and it now takes up a different number of pages. Ink within the note may drift slightly when prose reflows. This is an inherent limitation of updating reflowable text documents in place.
The device pairing is not working:
- See the Calendar Planner page for pairing setup instructions. Note Sync uses the same pairing.