Stella
Reading and writing

Convert Markdown to PDF, nicely formatted

Three Markdown notes as clean PDFs, tables, code, tick boxes and the map included.

Download StellaFree with the plan you already have.

A real run on 14 November 2026, on a Linux computer, using Claude Code with Opus, on a Claude plan. Shown 7× faster; it took 2 min 15 s.

The short answer.

Open the note in VS Code, install the free Markdown PDF extension and run its Export (pdf) command, or open any Markdown preview and print it to PDF. Run it on the note in its own folder so linked pictures are found. Stella (stella.sh) turns every note in a folder into a styled PDF on your computer, checks each page and keeps pictures from splitting awkwardly across pages.

Stella does this on Windows, Mac and Linux.

What happened.

Three PDFs in under 2 minutes. Checked afterwards against an answer key written before the run: one PDF per note with all the text there, no Markdown symbols left, headings larger than body text, bold and italic in bold and italic fonts, tables laid out in rows and columns, the map picture embedded, the link clickable, code in a monospace font, and the notes unchanged.

The notes were written for this run. The trip note runs to 2 pages because Stella moved the map to the top of page 2 rather than split it. The work is sped up 7×.

How Stella does it.

  1. Finds the three notes in Documents/Notes and the trip note's map picture in its images folder
  2. Installs a small Markdown library into a work folder and writes a converter that lays each note out as a styled page
  3. Prints each page to PDF with the browser already on the computer, so tables, code blocks, links and tick boxes come out properly
  4. Renders every page to an image to check it, then adjusts how the tick boxes look and keeps the map and its caption together on page 2 of the trip note
  5. Saves each PDF next to its note under the same name and leaves the notes unchanged

The prompt.

Turn the Markdown notes in my Documents into nicely formatted PDFs.

Paste it into Stella and press Enter.

This is the exact prompt from the recording. If your files are somewhere else, say where.

Do it yourself.

  1. In VS Code

    Install the free VS Code, open the notes folder, and add the Markdown PDF extension from the Extensions panel. Open a note, press Ctrl+Shift+P (Cmd+Shift+P on a Mac) and run Markdown PDF: Export (pdf). The PDF lands next to the note.

  2. Or print a preview

    Any Markdown preview can be printed: in VS Code press Ctrl+Shift+V (Cmd+Shift+V) to preview, or open the note in an app such as Typora or Obsidian, then print and choose Save as PDF. Turn on background graphics so table shading and code backgrounds print.

  3. Or use pandoc

    With pandoc installed, pandoc note.md -o note.pdf makes a PDF, but it needs a LaTeX engine as well. A lighter route is pandoc note.md -o note.html and printing the HTML from a browser.

  4. Check the pages

    Look for tables cut off at the right edge, pictures split across pages and code lines running off the page. Landscape pages or a smaller font fix wide tables.

Where it stops.

  • Very wide tables may wrap or need landscape pages on a portrait PDF.
  • The PDF follows Stella's own clean styling. Ask for a font, page size or margins you prefer and it redoes them.
  • The notes' text goes to the AI model you use in Stella while it converts them, along with page images it checks. The PDFs are made on your computer.
  • Recorded on Linux, where a browser for printing was already installed. Stella added a small Markdown library to its own work folder. On a Mac or Windows PC it would use the browser you have, which wasn't recorded.

Questions.

Why are my images missing from the PDF?

Markdown links pictures by path, such as images/map.png. If the converter runs from another folder, it can't find them. Convert from the note's own folder.

Can I convert a whole folder of notes at once?

With pandoc you run one command per note (or a loop). Stella converts every note it finds in the folder in one go.

Do tick-box lists work in a PDF?

They print as ticked and empty boxes; they aren't clickable in the PDF.

I need a Word file instead.

See convert Markdown to Word. To number the pages of a long note, see add page numbers to a PDF.

Is Stella free for this?

Yes. Free with the ChatGPT or Claude plan you already have. Sign in with your ChatGPT plan, or use your Claude plan through Claude Code, and this task costs nothing extra. New accounts also get a small free trial of Stella’s own models.

Can I control what Stella changes on my computer?

Yes. Stella works on Windows, Mac and Linux with your own files and shows each step in the chat, so you can watch it and stop it at any point. Tell it what it may not do, as the prompts on these pages do (“don't delete anything without asking”). In the Downloads recording it deleted nothing until it was told to go ahead. It also refuses commands that would wipe a whole disk, your home folder or system folders.

Checked against these sources on 14 November 2026.

Stella