Skip to content
Ayumi

Getting Started

Ayumi is available for free on the App Store for both macOS and iOS.

Installation

Section titled “Installation”
  1. Download Ayumi from the App Store
  2. Launch the app

Initial Setup

Section titled “Initial Setup”

On first launch, Ayumi will ask you to select a folder for storing your journal entries.

Choosing a Folder

Section titled “Choosing a Folder”
  • Select a folder on your iCloud Drive to enable automatic sync across devices
  • Alternatively, choose any local folder on your device
  • The folder will contain your Markdown files and attached media

Folder Structure

Section titled “Folder Structure”

Ayumi organizes entries by date:

YourJournalFolder/
├── 2026/
│   ├── 01/
│   │   ├── 01/
│   │   │   ├── morning-thoughts.md
│   │   │   └── morning-thoughts.assets/
│   │   │       └── photo.jpg
│   │   └── 15/
│   │       └── weekly-review.md
│   └── 02/
│       └── ...

Each entry is a standard Markdown file with YAML frontmatter for metadata. Attached files are stored in a .assets/ folder alongside the entry.

Creating Your First Entry

Section titled “Creating Your First Entry”
  1. Tap the New Entry button (or use Cmd+N on macOS)
  2. Write your thoughts in Markdown
  3. Location and weather data are captured automatically
  4. Save with Cmd+Return (macOS) or the Save button

What’s Next

Section titled “What’s Next”