Writing Entries

Ayumi provides a distraction-free writing experience with Markdown support and rich metadata.

Creating an Entry

• macOS: Click the + button in the toolbar or press Cmd+N
• iOS: Tap the New Entry button
• Quick Action (iOS): Long-press the app icon and select “New Entry”
• macOS Quick Entry: Use the global hotkey to open a floating entry window from anywhere

When you create an entry, Ayumi automatically captures:

• Location — Your current location with place name
• Weather — Temperature and conditions via Apple WeatherKit

Editing

Write in standard Markdown. The editor supports:

• Headings, bold, italic, lists
• Links and inline code
• Block quotes and code blocks

The entry title is derived from the first line of your Markdown content.

Tags and Favorites

• Tags: Add custom tags to organize entries. Use the tag field in the metadata section.
• Favorites: Mark important entries with the star icon for quick filtering.

Filtering and Search

In the entry list:

• Search: Type in the search bar to filter by title or body text
• Tag Filter: Select a tag from the dropdown to show matching entries
• Favorites: Toggle the favorites filter to show only starred entries

Entry List

Entries are grouped by date with the most recent first. The list shows:

• Entry title (first line of Markdown)
• Preview text (first 200 characters)
• Date and time
• Favorite and tag indicators

The list supports pagination (50 entries per page) for performance with large journals.

Map View

View all entries with location data on an interactive map. Each marker shows the entry title, and you can tap to navigate to the full entry.

Deleting Entries

Swipe left on an entry (iOS) or use the context menu to delete. The Markdown file and its attachments folder will be removed.