pi-umbra-preview

Render a document with pandoc and open it in the browser, from inside pi.

Packages

Package details

extension

Install pi-umbra-preview from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-umbra-preview
Package
pi-umbra-preview
Version
0.1.3
Published
Sep 27, 2026
Downloads
228/mo · 7/wk
Author
grknbyk
License
MIT
Types
extension
Size
11.8 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-umbra-preview

/umb-preview <file> opens a document in your browser, rendered. A Markdown file in the terminal is its source text. This turns it into a page with pandoc.

pi install npm:pi-umbra-preview
Command Effect
/umb-preview README.md render with pandoc, open in the browser
/umb-preview @docs/plan.md a leading @ from pi's file picker is fine
/umb-preview report.pdf open as it is
  • A path is taken from the folder pi was started in.
  • .pdf, .html, .htm, .svg, .png, .jpg, .jpeg, .gif and .webp open directly.
  • Anything else goes through pandoc into one self-contained file in <temp>/pi-umbra-preview/.
  • Mermaid blocks are drawn as diagrams. The page loads mermaid from the jsDelivr CDN for that, so it needs a network connection.

pandoc

pandoc is not included. Nothing checks for it until you preview a file, and if it is missing pi tells you how to install it:

System Command
Linux sudo apt install pandoc, or your distribution's package
macOS brew install pandoc
Windows winget install --id JohnMacFarlane.Pandoc -e

MIT.