Folra plugins
Install a .folraplug package in Folra, or use the development guide to build your own plugin.
Official plugins
View GitHub releasesMarkdown Check
Find heading jumps, empty links, missing image descriptions, and unresolved reference links in the current document.
Quick Templates
Start a meeting note, reading note, or journal entry from a template in English, Chinese, or Japanese.
Chinese Typography
Add spacing between Han characters and Latin letters or digits. Optionally adjust punctuation in Chinese prose.
Build a plugin
A plugin starts with a JSON manifest and a JavaScript command. Build it with Folra’s CLI or give the development guide to your coding agent.
- Selection or document
- Choose the text your command receives. Check a document, clean up a selection or generate a template.
- Native parameters
- Set plugin options with text fields, dropdowns, and toggles when you run a command.
- Text and edits
- Copy or insert text returned by a plugin, or preview proposed edits before applying them.
Workspace tools and editor extensions
These capabilities require Folra 0.1.16 or later and Plugin API 4. Plugin scripts run in a sandbox.
- Notes, images, and OCR
- Request access to Markdown notes and images in the workspace, recognize text in images on your Mac, and propose file changes for review.
- Native tools and shortcuts
- Add a native sidebar or tool window, keyboard shortcuts, completions, or rendering for custom code blocks.
- Network requests
- Plugins declare which HTTPS hosts they use. Folra shows the destination and request details and asks before sending each request.
Unzip and install the example using the steps below. Select a few plain-text lines and run Plain text tools from the Plugins menu to sort them, remove duplicates or add a prefix.
Get started with the CLI
These commands use Folra in Applications. The scaffold includes a working command and test cases you can edit. Run the tests again after changing the command, then package it to a new folder.
folra="/Applications/Folra.app/Contents/MacOS/Folra"
"$folra" plugin scaffold ./MyPlugin --api 2 \
--id com.example.my-plugin --name "My Plugin" --scope selection
"$folra" plugin validate ./MyPlugin
"$folra" plugin test ./MyPlugin
"$folra" plugin pack ./MyPlugin ./MyPlugin.folraplugInstall a plugin
Local installation requires Folra 0.1.15 or later. Check the plugin’s minimum version before installing.
- Unzip a downloaded ZIP or use the .folraplug folder you built.
- In Folra, choose Plugins → Manage Plugins… → Install Plugin… and select the .folraplug folder.
- Open a Markdown document and run the plugin from the Plugins menu.