How Markpad Manages Documents, Tabs, and Files

Updated

Markpad organizes work around multi-window tabs, window tags, and session restoration, and keeps open documents in sync with changes on disk. You can paste or drag images and files straight into a document, and export finished work as HTML or a print-to-PDF. These features are available on the Windows, macOS, and Linux desktop builds; the site presents Markpad as free and open source with zero telemetry, though no separate pricing or login terms are stated.

Tabs, Windows, and Session Restoration

Markpad treats document organization as a first-class feature rather than an afterthought:

  • Tabs let you keep several documents open in one window and switch between them.
  • Multi-window support means you can spread documents across separate windows, which suits side-by-side work on different files.
  • Window tags give those windows labels so you can tell them apart at a glance.
  • Session restoration brings back your open tabs and windows the next time you launch the app, so an interrupted writing session doesn't mean reopening files one by one.

The practical effect: you can set up a workspace for a project — a notes file, a draft, and a reference document in tagged windows — close the app, and return to the same arrangement later.

Keeping Files in Sync with Disk

Markpad includes disk auto-reload: when a file changes on disk, the open document updates automatically. This matters if you edit the same file in another editor, receive an updated file from a collaborator, or generate content with a script. Instead of a stale buffer, the tab reflects the current file contents.

A reasonable workflow is to keep Markpad open on a file that another tool writes to — for example, a changelog generated by a build step — and let auto-reload surface each change without manual reopening.

Adding Images and Files by Paste or Drag

You don't need a separate upload step to bring assets into a document:

  • Paste images directly into the document from the clipboard.
  • Drag files in to open them in Markpad.

This is useful for screenshot-heavy notes or documentation drafts where you capture an image and drop it into the Markdown source in one motion. The site describes this as "paste and drop" support; it does not specify where pasted images are stored on disk, so check the resulting Markdown link path after your first paste if file location matters to you.

Exporting and Printing

Two output paths are documented:

Output What it produces Typical use
One-click HTML export A clean HTML file Sharing a rendered document or publishing to a site
Print-to-PDF A PDF via the print dialog Archiving, sending a fixed-layout copy, printing

Both are described as "clean," meaning the output is intended to reflect the rendered document rather than raw Markdown. If you need a PDF, use the print path and choose your system's PDF printer option.

How This Fits the Rest of the Editor

Document management works alongside Markpad's editing features, which affect how you move through long files:

  • A floating table-of-contents outline follows your scroll position, so navigation stays available in long documents.
  • Heading folding collapses sections you aren't working on.
  • Zen mode reduces interface clutter for focused writing.
  • Synchronized split view keeps source and preview aligned line for line.

The editor engine is Monaco (the VS Code editor component) with built-in Vim keybindings, and the app is built with Rust, Tauri, SvelteKit, and TypeScript — relevant if startup speed and resource use matter to you, since the site claims near-instant startup and efficient resource usage.

A Concrete Scenario

Suppose you maintain a project README plus a separate notes file:

  1. Open both files as tabs; put the README in its own tagged window.
  2. Paste screenshots into the notes file as you capture them.
  3. Edit the README in another tool; Markpad's auto-reload picks up the change.
  4. Use the outline to jump between sections while folding finished ones.
  5. Export HTML for the repo's docs site and print a PDF for review.
  6. Close the app; session restoration returns both windows and tabs next launch.

Limits to Keep in Mind

The site does not document a file browser or folder-tree sidebar, so organization relies on tabs, windows, tags, and your operating system's file dialogs rather than an in-app project explorer. It also doesn't specify image storage behavior for pasted content. If either matters for your workflow, test with a sample document before committing a large project to the app.