---
id: "open-markdown"
type: "concept"
title: "Open Markdown baseline"
summary: "Every knowledge item ships as readable Markdown plus indexes — the SDK is optional."
problem: "Knowledge trapped in generated JS or HTML blocks offline and agent workflows."
why: "Agents and humans must grep, read, and pack the same facts without executing code."
mentalModel: "INDEX.md and SEARCH.json are the door; Markdown files are the rooms."
audiences: ["developers"]
related: ["explicit-authoring"]
next: ["guide-vs-scenario"]
packageVersion: "1.4.2"
updatedAt: "2026-07-30T16:00:45.570Z"
---
# Open Markdown baseline

Every knowledge item ships as readable Markdown plus indexes — the SDK is optional.

## Problem

Knowledge trapped in generated JS or HTML blocks offline and agent workflows.

## Why

Agents and humans must grep, read, and pack the same facts without executing code.

## Mental model

INDEX.md and SEARCH.json are the door; Markdown files are the rooms.