This is the first post on this site — and it's also a small demonstration of how Obscura works. What you're reading is a Markdown file in site/content/posts/. The photo below is pulled in from a gallery using a shortcode. Everything else — the layout, the responsive image, the metadata card — Obscura handles.
Photos in Blog Posts
One of the things I wanted Obscura to do well is let you weave photos into your writing. You reference a photo by its slug, and Obscura renders it as a styled card with the image and whatever metadata is available.
Here's what that looks like in practice:
The Markdown source for that embed is just a single line:
{{</* photo "sample-01" */>}}
sample-01 is the filename slug — the image filename without its extension. If the same filename exists in more than one gallery, you use the full form instead: gallery/photo (e.g., samples/sample-01). Obscura catches ambiguous or broken references at build time, so you won't end up with missing images in production.
Writing and Photography, Together
Blog posts in Obscura are plain Markdown with frontmatter for title, date, tags, and an optional summary. You can mix text and photo shortcodes freely — write about a trip, drop in the shots, and let the reader experience both together.
The sidecar workflow explains how photo metadata works. The Getting Started guide covers the full setup. And if you're curious about the thinking behind the project, there's a post on why Obscura exists at all.