What is a Space

A Space is a folder on your computer that Glyph treats as your notebook. Notes inside it are plain Markdown files (.md). You pick the folder. Glyph reads and writes those files on disk.

Notes on disk

Open a Space and create a note. Glyph saves a .md file in that folder. You can open the same file in another Markdown editor, move it in Finder, or put the folder in Git. Glyph does not lock your notes into a private database.

Folders inside the Space become folders in the sidebar. Nested folders work the same way.

Hidden .glyph metadata

Glyph keeps a hidden .glyph folder inside the Space for app metadata (for example pinned files). That folder is for Glyph. Your notes stay as ordinary Markdown beside it.

Other Markdown apps ignore .glyph. Your writing stays portable.

Search index

Glyph builds a search and links index so you can find notes, tags, and connections. That index lives in app support on your Mac, separate from the Space folder. If search looks stale, rebuild it from Settings → Space → Search Index.

The index is derived data. Your source of truth is the folder of Markdown files.

Compatible with other apps

Because notes are Markdown files:

• You can open them in Obsidian, Typora, VS Code, or any text editor.
• You can back up the Space folder with Time Machine, rsync, or cloud sync of your choice.
• You can share a single note by sending the .md file.

Wikilinks ([[Note]]), tags, and frontmatter follow common Markdown habits. Features unique to Glyph (pins, Folio layout, Connections) use Glyph metadata or the index, so they may not appear in other apps.

Reveal Space

Use Reveal Space to open the Space folder in Finder. You see the same files Glyph uses: notes, folders, and the hidden .glyph directory (if Finder shows hidden files).

Reveal Space when you want to confirm where files live, attach something outside Glyph, or copy a path.

Close Current Space

Use Close Current Space when you want to leave this folder without quitting Glyph. The welcome screen returns so you can open another folder or create a new Space.

Closing a Space does not delete files. The folder stays on disk. Open it again with Open Space (Cmd+O) or from Recent Spaces.

One Space at a time

Glyph works with one Space in the main window. Switch Spaces by closing the current one and opening another, or by picking a path from Recent Spaces.

Keep separate Spaces for separate projects if you want clean boundaries. Or keep one large Space and use folders inside it.

Tips

• Prefer rename and move inside Glyph when notes link to each other, so wikilinks can update.
• Treat .glyph as Glyph’s bookkeeping. Do not hand-edit it unless you know what you are changing.
• Shortcuts such as Reveal Space and Close Current Space are remappable under Settings → Shortcuts (Keyboard Shortcuts).