# 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.

- Skill: `majiayu000/cursor-remarkable-upload` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/cursor-remarkable-upload`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/cursor-remarkable-upload/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/cursor-remarkable-upload

---


# 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`.