Skip to content

OpenShelf 1.6.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 02:37

Markdown that converts properly, and Pandoc when you have it.

New

  • Pandoc, when it's installed. With Pandoc
    (brew install pandoc), Markdown becomes Word, HTML, EPUB and RTF through it,
    and Word, ODT and HTML documents become Markdown and EPUB. PDFs go through
    Pandoc too when a typesetter such as MacTeX, Tectonic or Typst is installed.
    Settings → Extra Formats shows whether it was found. If Pandoc fails, the
    built-in conversion runs instead.

Fixed and improved

  • Markdown converts properly. Markdown to PDF, Word, HTML, RTF and plain
    text used to come out as the Markdown source itself, asterisks and all
    (#5). Headings,
    emphasis, lists, quotes, code blocks, tables, links, pictures, footnotes and
    math are now the real thing in every format, and Word files use Word's own
    heading styles, numbered lists and footnotes. Pandoc's definition lists,
    simple and multi-line tables, line blocks, math and smart quotes are read
    too. Thanks to @wada3n for the report and the
    comparison files.
  • Word documents to PDF keep their layout when LibreOffice is installed.

Install

  1. Download OpenShelf-1.6.0.dmg below, open it and drag OpenShelf onto Applications.
  2. Open OpenShelf from Applications. It lives in the menu bar (the wheel icon).
  3. OpenShelf isn't notarized by Apple yet, so macOS asks once on first launch:
    • macOS 15 and later: click Done, open System Settings → Privacy & Security, scroll down and click Open Anyway.
    • macOS 14: right-click the app → Open → Open.
    • Or run xattr -dr com.apple.quarantine /Applications/OpenShelf.app

Requires macOS 14 Sonoma or later, on Apple silicon or Intel. See the README for how to use it.