Skip to content

podlite/podlite-desktop

Repository files navigation

Podlite Desktop

A block-based markup editor for Podlite with live preview. Available on Windows, Linux and macOS.

GitHub release License: MIT Mac App Store Microsoft Store Snap Store

Get Podlite

Download the latest release:

Also available from Mac App Store, Microsoft Store and Snap Store.

Smart Lists

Press Enter to continue a list. Checkboxes and numbered markers carry over to the next item.

Smart Lists

Tab increases nesting level. Shift+Tab decreases it. Works with plain lists, numbered lists and task lists.

Nesting Levels

Code Folding

Collapse =begin/=end blocks and =head sections to navigate large documents. Fold state is preserved between sessions.

Code Folding

Collapsible Blocks

Add :folded to any block to make it collapsible in preview. Use :!folded for expanded by default.

Folded blocks

Images: Drag-Drop or Paste

Drop an image from Finder onto the editor, or paste a clipboard image with Cmd+V. The file is saved to a media/ folder next to the document and an =picture media/<name> line is inserted at the cursor. A file already living in media/ is referenced in place without copying.

Drag-drop and paste

Features

Editor

  • smart list continuation on Enter with preserved type prefix ([ ], #)
  • Tab / Shift+Tab to change nesting level
  • code folding for =begin/=end and =head sections (Ctrl+Shift+[ / Ctrl+Shift+])
  • image drag-drop and clipboard paste — auto-inserts =picture media/<name>
  • near-zero input latency on large documents
  • syntax highlighting for Podlite markup, including semantic blocks (=TITLE, =NAME, =Diagram)
  • text search (Cmd+F / Ctrl+F)

Preview

  • live preview while you type
  • split view (Cmd+. / Ctrl+.)
  • full preview (Cmd+\ / Ctrl+\)
  • collapsible blocks with :folded attribute and recursive folding for headings
  • automatic heading numbering with :numbered and =config head1 :numbered
  • =include resolved at render time, with a file watcher that refreshes the preview when included files change
  • export to HTML and PDF

Workspace

  • session restore: cursor position, scroll, folds, view mode
  • per-file view mode persistence (editor / split / preview)
  • auto-reload when file changes on disk — including atomic-write edits from IDEs and sync tools
  • import from Markdown

Blocks and Extensions

  • =markdown — GitHub Flavored Markdown
  • =Mermaid — diagrams and charts
  • =formula — math formulas
  • =picture — images and video
  • =toc — table of contents
  • =table, =row, =cell, =data-table — structured and CSV/TSV-sourced tables with :folded support
  • =config — block preconfiguration (defaults applied to every block of a type)

Podlite Blocks

=markdown

Switch to GitHub Flavored Markdown inside a Podlite document:

=begin markdown

# Heading

*Write* the docs with the markup you __love__!

* item 1
* item 2

=end markdown

Try in pod6.in

=Mermaid

Render diagrams, flowcharts and sequence diagrams:

=begin Mermaid
graph LR
    A-->B
    B-->C
    C-->A
    D-->C
=end Mermaid

Mermaid diagram

Try in pod6.inMermaid syntax reference

=toc

Generate a table of contents from headings:

=for toc :title('Table of contents')
head1, head2, head3

=picture

Embed images or video:

=picture photo.png
A caption for the image

Documentation

Contributing

This is an open source project. Feel free to fork and contribute.

Please submit pull requests against the develop branch to keep documentation in sync with the latest release.

Linux Note

AppImage permissions

Links

Podlite

Author

Copyright (c) 2020–2026 Alexandr Zahatski

License

Released under a MIT License.