textbook-to-md

# Textbook-to-Markdown Converter > This skill calls scripts in your clone of the textbook-to-note repo. At > install time, replace `{REPO}` below with the absolute path of the clone. ## Purpose Convert PDF or EPUB textbooks into **searchable markdown** that the agent can grep/read directly, eliminating the need for PDF-library extraction at every query. Output lives outside the note vault, at the path configured by `OUTPUT_DIR` in `shared/config.py` (default `./output/`), and is for the agent's consumption, not for the user's reading. > **Figures are on-demand, not pre-extracted.** This skill produces markdown > text only. Figures are extracted one at a time *when a note needs them*, > via the `figure-remap` skill's entrypoint (QC-gated). Do not batch-extract > a whole book's figures into a `figures/` folder — that approach does not > scale and is unnecessary since the on-demand path already handles it. A > legacy `figures/` folder may exist for books converted before this design; > new conversions are markdown-only. ## When to use - User explicitly asks to convert a textbook or chapter - You need to search textbook content and want to avoid per-query PDF re-parsing overhead - Building up a knowledge base from a personal library of reference books - Before starting work on a new topic, convert the relevant chapters first ## Quick reference ```bash # Single file python {REPO}/converter/convert.py "path/to/chapter.pdf" # Single file with custom output and label pyth...