> ## Documentation Index
> Fetch the complete documentation index at: https://docs.glassine.ink/llms.txt
> Use this file to discover all available pages before exploring further.

# Glassine

> A quiet Markdown writing app for macOS.

<Frame>
  <img src="https://mintcdn.com/glassine/dNQTsBjDirbzU-UJ/images/editor.jpg?fit=max&auto=format&n=dNQTsBjDirbzU-UJ&q=85&s=0201d3bd774c671ea993857e88a6e302" alt="An essay open on a sheet of dark glass, the library in a sidebar on the left" width="1440" height="900" data-path="images/editor.jpg" />
</Frame>

Glassine is a place to write. The window is a sheet of translucent glass over whatever is behind it. The caret glides instead of jumping. Your documents are plain Markdown files in iCloud Drive, saved as you type, and a Craft-style sidebar hides with one key.

It is a native Mac app, Swift from top to bottom, with no accounts, no analytics and nothing sent anywhere. The source is [on GitHub](https://github.com/a-libre/glassine) under the MIT license.

*Glassine is the thin, translucent paper used to protect prints.*

## Where to begin

<CardGroup cols={2}>
  <Card title="Install" icon="download" href="/install">
    The Mac App Store, a direct download, or a build from source.
  </Card>

  <Card title="The first ten minutes" icon="pen-line" href="/getting-started">
    The window, the sidebar, and the keys worth learning first.
  </Card>

  <Card title="Keyboard shortcuts" icon="keyboard" href="/reference/shortcuts">
    Every key, on one page.
  </Card>

  <Card title="Small delights" icon="sparkles" href="/reference/small-delights">
    The little things that move, and where to find them.
  </Card>
</CardGroup>

## What it does, in one screen each

<Frame caption="Focus mode with typewriter scrolling: the paragraph being written stays put, the rest steps back.">
  <img src="https://mintcdn.com/glassine/dNQTsBjDirbzU-UJ/images/focus.jpg?fit=max&auto=format&n=dNQTsBjDirbzU-UJ&q=85&s=ca97d55370a616f249bbd4a75582de80" alt="Focus mode with typewriter scrolling" width="1440" height="900" data-path="images/focus.jpg" />
</Frame>

<Frame caption="Review: the same document rendered as a finished page, here in the Glass style.">
  <img src="https://mintcdn.com/glassine/dNQTsBjDirbzU-UJ/images/review.jpg?fit=max&auto=format&n=dNQTsBjDirbzU-UJ&q=85&s=333e1037ac86a85f482b14efa4aa6a7a" alt="Review mode in the Glass style" width="1440" height="900" data-path="images/review.jpg" />
</Frame>

<Frame caption="All Documents: the library laid out as a wall of cards.">
  <img src="https://mintcdn.com/glassine/dNQTsBjDirbzU-UJ/images/library.jpg?fit=max&auto=format&n=dNQTsBjDirbzU-UJ&q=85&s=fbdabc12a1823c064d4a4388a40f8d37" alt="All Documents, the mosaic view" width="1440" height="900" data-path="images/library.jpg" />
</Frame>

<Frame caption="Timelapse: today's note in front, earlier days receding behind it.">
  <img src="https://mintcdn.com/glassine/dNQTsBjDirbzU-UJ/images/daily.jpg?fit=max&auto=format&n=dNQTsBjDirbzU-UJ&q=85&s=b81d9501dcd8fdf64be85fc28206902e" alt="Timelapse, the corridor of daily notes" width="1440" height="900" data-path="images/daily.jpg" />
</Frame>

## The short version

* **Glass.** The window is a blur of what is behind it, tinted by the theme. Nine built-in themes, dark by default; make your own with live preview and export it as JSON.
* **A smooth caret.** The insertion point glides between positions. Speed, blink style and width are yours to set.
* **A library, not a file picker.** Documents live in `iCloud Drive/Glassine` as `.md` files and folders. ⌘N makes one; it takes its name from the first line as you write.
* **Autosave** half a second after you stop typing, and at least every few seconds while you type.
* **A sidebar** with Recents, Starred, folders, tags and a Shelf, shown and hidden with ⌘S.
* **All Documents** (⌘1): a mosaic of every document with rendered previews, navigable with the arrow keys.
* **Review** (⌘↩): the document rendered as a page in one of five styles.
* **Typewriter scrolling, focus mode, word count and reading time.**
* **Markdown, lightly styled.** Syntax stays visible but steps back.
* **Copy the whole document** as Markdown (⌘⇧C) or rich text (⌥⌘C); export it as a PDF (⌘⇧E).
