cursor-remarkable-upload

Upload markdown (including docmgr ticket docs) to a reMarkable device as PDF via a local uploader script, with a safe dry-run and optional mirroring of ticket structure. Use when the user asks to send docs to reMarkable, export markdown to PDF for reMarkable, or troubleshoot rmapi/pandoc/xelatex.

⭐6stars🔀2forks📁View on GitHub🕐Updated Jan 5, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill automates the conversion of Markdown documents into professional PDF files and facilitates seamless uploads to reMarkable paper tablets. By integrating powerful tools like Pandoc, xelatex, and rmapi, it streamlines the transition from digital drafting to distraction-free reading, ensuring high-quality rendering and organized file management.

Use Cases

  • Scenario 1: Converting technical documentation or project tickets into PDFs for offline review and handwritten annotation on a reMarkable device.
  • Scenario 2: Maintaining organizational context by mirroring complex local folder or ticket structures directly onto the reMarkable file system.
  • Scenario 3: Automating the document processing pipeline for writers and researchers who need to move Markdown drafts to e-ink screens without manual conversion steps.
  • Scenario 4: Troubleshooting and managing local environment dependencies for document conversion, including Pandoc and LaTeX configurations.
namecursor-remarkable-upload
descriptionUpload markdown (including docmgr ticket docs) to a reMarkable device as PDF via a local uploader script, with a safe dry-run and optional mirroring of ticket structure. Use when the user asks to send docs to reMarkable, export markdown to PDF for reMarkable, or troubleshoot rmapi/pandoc/xelatex.

Cursor Remarkable Upload

Overview

Safely convert .md to .pdf and upload to a reMarkable device, defaulting to dry-runs and avoiding overwrites.

Preconditions

  1. Confirm uploader exists: python3 /home/manuel/.local/bin/remarkable_upload.py --help
  2. Confirm dependencies if needed: rmapi, pandoc, xelatex

Workflow (safe default)

  1. Choose markdown file(s) (use absolute paths).
  2. Dry-run:
    • python3 /home/manuel/.local/bin/remarkable_upload.py --dry-run /abs/path/to/doc.md
  3. Upload (no overwrite):
    • python3 /home/manuel/.local/bin/remarkable_upload.py /abs/path/to/doc.md
  4. 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.