Skip to content
girok-md

Introduction

Your record becomes a map for others.

girok.md (기록.md) is an open-source static blog generator built with Astro. It transforms your Obsidian markdown files into a beautiful, fast, and SEO-optimized blog.

The name combines girok (기록, Korean for “record” or “documentation”) with .md (Markdown). It reflects the core philosophy: your personal records, written in Markdown, become valuable documentation for others.

Philosophy

The Power of Recording

  • Personal Records: Traces left behind so you don’t forget what you’ve learned.
  • Shared Records: Milestones from your journey that help others grow.

Your notes are more than personal memos—they become a map that guides someone else’s path.

Key Features

Markdown Native

Full support for Wikilinks ([[link]]), image embeds (![[image.png]]), and Callouts (> [!NOTE])

Incremental Sync

Only syncs changed files based on publish_sync_at timestamp for optimized build times

Full-Text Search

Client-side search powered by Pagefind - fast and privacy-friendly

Reading Time

Estimated reading time for each post - supports both Korean (CPM) and English (WPM)

SEO Optimized

Auto-generated sitemap, meta tags, and Open Graph support

Post Translation

Automatically translate posts to multiple languages using AI or Google Translate

Tech Stack

  • Framework: Astro 5.x
  • Language: TypeScript (strict mode)
  • Markdown: remark, rehype, remark-obsidian
  • Search: Pagefind
  • Testing: Vitest, Playwright