v1.1.0 - YAML Frontmatter & Link Metadata

What's New

YAML Frontmatter

All bookmark files now include rich YAML frontmatter:

---
id: "2016987515279069403"
author: DanielleFong
author_name: "Danielle Fong 🔆"
date: 2026-01-29
url: https://twitter.com/DanielleFong/status/2016987515279069403
thread_length: 3
reply_count: 15
media_count: 2
quoted_tweet: "2016985000000000000"
hashtags:
  - ClaudeCode
  - AI
links:
  - url: https://github.com/anthropics/claude-code
    type: github
    owner: anthropics
    repo: claude-code
    stars: 12345
    language: TypeScript
---

Link Metadata Extraction

• GitHub repos: Fetches stars, description, language, topics from GitHub API
• Articles & YouTube: Extracts OpenGraph tags (title, description, site)
• Caching: Metadata cached locally for 7 days to avoid redundant requests

Hashtag Handling

• Hashtags are extracted from original tweet and listed in frontmatter
• All hashtags in tweet text are wrapped in backticks (#hashtag) to prevent Obsidian tag pollution

Backfill for Existing Bookmarks

New -F / --backfill-frontmatter flag (use with -R rebuild mode):

birdmarks -R -F  # Add frontmatter to all existing bookmarks

• Merges with any existing frontmatter (preserves custom fields you've added)
• Only adds frontmatter to files that don't already have birdmarks-generated frontmatter

Other Improvements

• Completion state tracking (knows when full catalog has been scanned)
• 136 tests with 71% function / 63% line coverage

Download

Platform	File
macOS Apple Silicon	birdmarks-darwin-arm64
macOS Intel	birdmarks-darwin-x64
Linux x64	birdmarks-linux-x64
Windows x64	birdmarks-win-x64.exe

Note: Binaries aren't signed. On macOS: xattr -d com.apple.quarantine birdmarks-darwin-*