Writing Entries
Ayumi provides a distraction-free writing experience with Markdown support and rich metadata.
Creating an Entry
Section titled “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
- Share Sheet (iOS): Share text or a link from any app and pick Ayumi to save it as an entry
When you create an entry, Ayumi automatically captures:
- Location — Your current location with place name
- Weather — Temperature and conditions via Apple WeatherKit
Entries saved from the share sheet capture location and weather too. Both are best-effort and time-limited, so a share still saves promptly when no location fix is available — in that case the entry is simply saved without them.
Editing
Section titled “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.
Selecting, Sharing and Copying Text
Section titled “Selecting, Sharing and Copying Text”In the entry detail view you can select any part of an entry — the body, and also the title, tags, place and weather — and drag over it to select a range, then use the system Copy or Share menu.
The More menu in the toolbar acts on the whole entry:
- Share… — Open the share sheet with the entry text
- Copy Text — Copy the entry text to the clipboard
To copy more than one entry, tap the copy button next to a date header in the entry list. It copies every entry for that day, oldest first, separated by a --- rule and preceded by the date. The whole day is copied even when the list is paginated, though any active search or filter still applies.
Tags and Favorites
Section titled “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
Section titled “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
Section titled “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
Section titled “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
Section titled “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.