Opening Markdown Outside a Workspace

On macOS, Octarine can open .md and .markdown files directly from Finder, even when they are not inside an Octarine workspace.

Open With Octarine

In Finder, right-click a Markdown file and choose Open With → Octarine. You can also set Octarine as the default app for Markdown files.

Octarine decides how to open the file:

• If the file belongs to a known workspace, Octarine opens it as a normal tab in that workspace.
• If it is outside every workspace, Octarine opens an isolated document window.

Editing an External Document

An external document uses the regular rich-text editor and saves changes back to the original Markdown file. The title bar shows its containing folder and file name.

Use:

• Reveal to show the original file in Finder
• Cmd + S to save immediately
• Add to workspace to copy the current document into one of your Octarine workspaces

Adding a document to a workspace copies it into that workspace, opens the new workspace copy, and closes the external-document window. The original file remains in its existing location.

Changes Made by Another App

Octarine watches the file for changes made by other apps. If the file changes on disk while you also have unsaved edits, Octarine pauses saving and asks you to choose:

• Reload from disk — discard your Octarine edits and load the external version
• Keep my edits — overwrite the disk version with the content currently in Octarine

Resolve the conflict before closing the window or adding the document to a workspace.

Quick Answers