Open a file with a different editor
Files opens text files and documents in editors. Markdown and Code are built in, and your project can have tools of its own that open certain file types. See What are your tools?
Before you start
- Use the computer app, with a project that’s on that computer.
Steps
Open the file’s menu
In Files, right-click a project file or document, or point to it and select the … button. The Open with group at the top lists every editor and tool that can open it. Default marks the one it normally opens with.


Choose an editor or tool
The file opens in it, or its open tab switches to it.
Switch from the tab
Select the small key at the start of the file’s tab to see the same list. A check marks the one the tab is using.


Make it the default for that file type
In the tab’s menu, choose the option that starts with Always open, such as Always open .md files with Code. It appears when the one the tab is using isn’t already the default.
Restart it if it acts up
In the tab’s menu, choose Restart followed by its name.
Good to know
- What you choose from Open with applies to that tab. If you close the tab and open the file again, it opens with the default.
- After the default come your project’s tools for that file type, then tools from your other projects, with their project’s name beside them, then tools that open any text file.
- You can also set defaults in Tools: open a tool’s … menu and choose an Always open option.
- The default for
.mdfiles also applies to documents. - To make a built-in editor the default again, switch the tab to Markdown or Code, then choose its Always open option.
- Pictures and other files that aren’t text always open in Files’ own viewer.
- If the editor or tool can’t edit a file without losing something, the file switches to Code, or to the document editor for a document, and a note at the top says why. When Markdown can’t keep a file, Document has a warning mark instead; select it to see why.
- Defaults are saved on each computer.
- New tool for .md files…, with the file’s type, comes after the tools in both menus. It starts a new tool with “Make a tool that opens .md files and “ in the message box. See Make a tool.
- The tab’s menu also has Change followed by the tool’s name, which starts a conversation to change it (not for Markdown or Code), and, for a tool with a page of its own, Open followed by its name and by itself.
- Editor plugins made with earlier versions of Enjoy, in the Enjoy folder in your home folder under Plugins, are listed too. For those, Change opens the editor as a project of its own, and Delete followed by its name moves it to the Trash and removes its project from Enjoy.
If something goes wrong
“couldn’t open this file”
The message starts with the editor’s or tool’s name and shows details below it. Select Try again. For a tool, select Change followed by its name to fix it with an agent, or choose something else from Open with.
“didn’t connect to Enjoy”
The tool’s page loaded but never connected. The full message, after the tool’s name, is “didn’t connect to Enjoy. Its page needs to load enjoy.js and call enjoy.connect().” Choose Change followed by the tool’s name, and pass that message to your agent.
The tab says the tool stopped
Select Start followed by the tool’s name.
“Couldn’t load your tools”
Enjoy couldn’t list its editors and tools, and the rest of the message says why. When the message says “so files open in the built-in editors”, Files opens files in the editors built into Enjoy until that’s fixed. Otherwise the ones Enjoy listed before still open files. Enjoy lists them again each time you come back to its window.
“Couldn’t read your choices of tool for each type of file”
Enjoy couldn’t read which editor or tool you chose to always open each type of file with, and the rest of the message says why. Files opens files in the built-in editors meanwhile. Enjoy keeps the file that holds your choices as it is.
“Couldn’t load this project’s tools”
The project’s enjoy-apps folder couldn’t be read, so its tools may be missing from Open with. See Open, pin, and stop a tool.
There’s no Open with group
You’re in the web app or the iPhone app, or you’re using another computer’s project. Choosing an editor or tool works only in the computer app, for projects on that computer. Menus in the archive don’t have the group either; restore the document first. See Archive and restore documents.