@gurupanguji

Snippet Posts Design Spec

Objective

Automate the creation of Jekyll blog posts from Obsidian snippets located in the rr vault under lit/snippets/. This enables a high-volume blogging workflow by leveraging the research and clipping process in Obsidian.

Context & Constraints

• Source: Obsidian vault rr, directory lit/snippets/.
• Tooling: obsidian CLI for vault interaction (read, files, vault=rr).
• Destination: Jekyll repository _posts/ directory.
• Protocol:
  • Filename: YYYY-MM-DD-slug.md.
  • Title Prefix: Always prepend 🔗 to the title front matter.
  • Front Matter:
    • layout: post
    • title: "🔗 <Obsidian Title>"
    • date: YYYY-MM-DD HH:MM:SS +0000 (derived from created property in Obsidian).
    • categories: [...] (inferred or default: ["external", "ramblings"]).
    • tags: [...] (copied from Obsidian, plus ["external", "links", "quotes"]).
• Content: The body content of the Obsidian snippet must be preserved exactly.

Workflow Detail

1. Discovery:
   • List files in lit/snippets/ for a target date (default: today).
   • Pattern: YYYY-MM-DD-*.
2. Extraction:
   • Use obsidian read to get the full content of each snippet.
   • Parse the YAML front matter from the snippet.
   • Parse the markdown body.
3. Transformation:
   • Map Obsidian properties (title, created, tags) to Jekyll properties.
   • Generate a slug from the title (lowercase, hyphens).
   • Prefix the title with 🔗 .
4. Generation:
   • Construct the Jekyll front matter.
   • Combine with the original body.
   • Save to _posts/YYYY-MM-DD-slug.md.

Edge Cases & Safety

• Existing Posts: Check _posts/ to see if a post with the same slug already exists to avoid duplication.
• Empty Properties: Fallback to filename parts if title or created are missing in the front matter.
• Slug Collisions: Ensure unique slugs for snippets with the same date and similar titles.