Cursor Remarkable Upload
Overview
Safely convert .md to .pdf and upload to a reMarkable device, defaulting to dry-runs and avoiding overwrites.
Preconditions
- Confirm uploader exists:
python3 /home/manuel/.local/bin/remarkable_upload.py --help - Confirm dependencies if needed:
rmapi,pandoc,xelatex
Workflow (safe default)
- Choose markdown file(s) (use absolute paths).
- Dry-run:
python3 /home/manuel/.local/bin/remarkable_upload.py --dry-run /abs/path/to/doc.md
- Upload (no overwrite):
python3 /home/manuel/.local/bin/remarkable_upload.py /abs/path/to/doc.md
- Only if explicitly requested: overwrite with
--force.
Ticket-aware uploads
- Prefer mirroring ticket structure to avoid name collisions; see
references/remarkable.md.
Reference
- Full usage + troubleshooting:
references/remarkable.md.
