Introduction

GDF (Guide Document Format) is a portable JSON standard for guides, handbooks, and playbooks.

Media type: application/vnd.guides.gdf+json

Design goals: human-readable Markdown bodies, machine-valid JSON, AI-friendly flat items[], application-agnostic structure, extensible namespaced metadata.

Out of scope for v1.0: permissions, editing workflows, automation, offline sync protocol.

Machine export: /g/{slug}/gdf ยท API: GDF API Reference