Markdown Format

Ayumi stores every journal entry as a standard Markdown file with YAML frontmatter.

File Format

---
id: "550e8400-e29b-41d4-a716-446655440000"
created_at: "2026-01-15T09:30:00+09:00"
updated_at: "2026-01-15T10:15:00+09:00"
tags:
  - daily
  - reflection
favorite: true
weather_summary: "Partly Cloudy"
weather_temperature_celsius: 12.5
location_latitude: 35.6762
location_longitude: 139.6503
location_place_name: "Shibuya, Tokyo"
---

# Morning Thoughts

Today I woke up feeling refreshed...

All fields are flat (no nesting), which ensures clean display in Obsidian’s Properties view.

Frontmatter Fields

Field	Type	Description
id	String	Unique identifier (UUID)
created_at	ISO 8601	Entry creation timestamp
updated_at	ISO 8601	Last modification timestamp
tags	String[]	Custom tags for organization
favorite	Boolean	Whether the entry is starred
weather_summary	String	Weather condition description
weather_temperature_celsius	Number	Temperature in Celsius (null if unavailable)
location_latitude	Number	Latitude coordinate (null if unavailable)
location_longitude	Number	Longitude coordinate (null if unavailable)
location_place_name	String	Reverse-geocoded place name (null if unavailable)
transcription_model	String	Model that produced the entry (transcribed entries only)
transcription_prompt	String	Prompt preset used for the transcription (omitted if none)

The two transcription_* fields are written only for entries produced by transcription, so entries you write by hand keep exactly the frontmatter they always had. Ayumi shows both in the entry detail view under a Transcribed label.

Obsidian Compatibility

Ayumi entries are fully compatible with Obsidian:

• Standard YAML frontmatter
• Standard Markdown syntax
• Attachment links using relative paths
• Tags appear in Obsidian’s tag system

You can open your Ayumi journal folder as an Obsidian vault and browse entries seamlessly.

Attachments in Markdown

When you add an attachment, Ayumi inserts a Markdown link:

![Photo](my-entry.assets/photo.jpg)
[Document](my-entry.assets/report.pdf)

The .assets/ folder is named to match the entry file, keeping everything organized.