SourceShelf app icon

SourceShelf

Turn webpages, files, and folders into local Markdown and OKF-compatible AI-ready knowledge packs.

Capture web pages from Safari, convert documents and documentation folders to Markdown, preserve useful images, and export structured AI Reference Packs — including Open Knowledge Format bundles — all locally on your Mac.

SourceShelf app screens showing Safari capture, folder conversion, generated Markdown, Shortcuts automation, and OKF-compatible AI Reference Pack export.

What it does

One shelf for source material, images, and AI-ready packs.

Capture, convert, search, validate, and package local source files without sending your work to a cloud conversion service.

01

Save sources as local Markdown

Capture webpages, files, and folders as clean Markdown with source metadata preserved.

SourceShelf save as Markdown screen showing local source capture options.
02

Clip web content from Safari

Save full pages, main content, selected text, or visible page areas directly from Safari, including browser-local images Safari can access during capture.

SourceShelf Safari clipping screen with options for full page, main content, selected text, and visible area.
03

Folder and documentation imports

Convert whole folders of PDFs, Office files, images, HTML, text, Markdown, and exported documentation sites.

SourceShelf batch conversion screen for converting a folder of supported files.
04

Recent with search and filters

Find the right sources fast, even when your local archive grows.

SourceShelf Recent screen with search and filtering controls.
05

Export AI-ready knowledge packs

Turn selected captures and documents into structured ZIP exports, including OKF-compatible bundles with Markdown pages, metadata, and an index.

SourceShelf AI Reference Pack builder showing selected sources, health checks, and OKF-compatible bundle export.
06

Scanned PDF OCR support

OCR scanned PDFs and images locally on your Mac.

SourceShelf OCR screen for scanned PDFs and images.
07

Generated Markdown with assets

Readable Markdown with source metadata preserved, plus images saved in clear sidecar folders like Page Name.assets.

SourceShelf generated Markdown preview with source metadata.
08

Private by design

Captures, assets, pack checks, cleanup, and exports all happen locally on your Mac with no cloud processing or telemetry.

SourceShelf privacy screen describing local-first processing.
09

Shortcuts / Automation

Automate Markdown conversion with Apple Shortcuts.

SourceShelf Shortcuts automation screen for Markdown conversion workflows.

AI Reference Packs

Know what is ready before you export.

Pack Health helps you understand what will be bundled, what needs attention, and what remains linked before creating a reusable knowledge pack or OKF-compatible export.

Pack readiness

  • See whether selected content is ready, has warnings, or needs attention.
  • Spot missing Markdown, broken local image links, missing archived images, and duplicate page names early.

Clear bundle contents

  • Each selected source becomes its own Markdown page for easy browsing and reuse.
  • Export OKF-compatible bundle ZIPs based on Google's Open Knowledge Format (OKF) specification.
  • Remote images, skipped media, and linked documents are called out when they remain links instead of bundled files.

Images travel with content

Web screenshots, diagrams, embedded images, and browser-local images from authenticated apps like Confluence can travel with captured Markdown when Safari can access them.

Safer long-term archives

Images are owned by the SourceShelf item record, so moving or deleting an exported Markdown file does not automatically destroy the archived assets.

Details

Built for real source folders, with honest boundaries.

Supported inputs

  • Safari captures
  • PDFs with selectable text
  • Scanned PDFs via local OCR
  • TXT
  • Markdown
  • HTML
  • Exported HTML documentation folders
  • Confluence-style HTML exports
  • RTF
  • PNG
  • JPEG
  • TIFF
  • HEIC/HEIF where supported
  • DOCX
  • PPTX
  • XLSX
  • Folders containing supported files

Current limitations

  • Legacy Office files .doc, .ppt, .xls are not currently supported.
  • OCR is best effort.
  • Complex document layout may not be preserved perfectly.
  • Folder structure mirroring and folder watching are not currently included.