What are editor plugins?

The built-in editors are plugins

Enjoy comes with two plugins:

• Markdown opens .md and .markdown files as a formatted page, the Document view. If it can’t keep a file exactly as it is, for example because the file contains HTML, it hands the file to Code and says why.
• Code opens any text file with colors for its language. It’s also the Source view of a Markdown file.

Documents open in Enjoy’s document editor, which is built on the Markdown editor and adds titles, pins, images, and archiving. You can also open a document in another plugin that handles .md files. The title, pin, and archive stay with Enjoy.

What a plugin can and can’t do

• A plugin edits one file at a time, the one you opened with it.
• Enjoy does the loading and saving: it hands the plugin the file’s text and saves the changes the plugin reports. Enjoy doesn’t give a plugin access to your other files. Autosave, unsaved drafts, and conflict handling work the same as in the built-in editors.
• A plugin can start a conversation about some text, open a web link in your browser, or switch the file to another editor.
• A plugin is a program that runs on your computer. Use plugins you or your agents made, or ones from people you trust.

The Plugins shelf

On Files home, select Plugins at the top to see every plugin as a card. New plugin is the first card. Your own plugins come next, then the built-in ones, marked Built in. Type in Search plugins… to find one by name, and select Files to go back.

Each card shows the file types the plugin opens, such as .md, or Any text file. A badge such as Default for .md means files of that type open with it. Your own plugins have an Edit button. The menu on each card has Restart and, for each file type the plugin names, an Always open choice. A plugin that can’t be used shows what’s wrong and an Edit plugin button.

Where plugins work

• Plugins work in the computer app, for projects on that computer.
• The web app, the iPhone app, and the computer app showing another computer’s projects use Enjoy’s built-in editors instead.
• Your plugins are folders inside the Enjoy folder in your home folder, under Plugins. Each has a file named enjoy-plugin.json with its name and the file types it opens.
• Which plugin opens each file type is saved separately on each computer.

Next steps

• Open a file with a different editor
• Create or change an editor plugin