Andrej Karpathy, Google and Garry Tan agree Markdown is the answer, but they're not solving the same problem
Key Points
- 1Andrej Karpathy, Google, and Garry Tan have all independently identified Markdown as the preferred format for AI agent memory and organizational knowledge storage.
- 2While Karpathy focused on personal knowledge bases, Google introduced the Open Knowledge Format for enterprise context, and Garry Tan utilized Markdown-based specialist roles to power his highly popular gstack setup.
- 3This trend signals a shift in the AI industry where the strategic "moat" is moving away from proprietary model architectures toward the open, readable file structures that agents use to interact with data.
The article "Andrej Karpathy, Google and Garry Tan agree Markdown is the answer, but they’re not solving the same problem" explores the emergence of Markdown as the standardized, cross-platform "substrate" for AI agent memory, context, and instruction. Rather than relying on proprietary databases or complex binary formats, industry leaders are converging on plain-text Markdown files as the optimal interface for autonomous agents to read, write, and maintain organizational knowledge.
Core Methodologies and Approaches
The paper details three distinct technical implementations of this "Markdown-first" philosophy:
- Agentic Memory (Andrej Karpathy): Karpathy’s "LLM Wiki" methodology treats memory as a dynamic graph of linked Markdown files. By utilizing the model's ability to maintain cross-references and perform bulk file operations across multiple documents in a single pass, this approach enables an agent to curate a personal knowledge base that remains human-readable and model-parseable.
- Enterprise Context (Google): The Open Knowledge Format (OKF) v0.1 functions as a standardized schema for encapsulating organizational data, including runbooks, metrics, and complex tables. By encoding enterprise information in plain Markdown, Google seeks to decouple contextual knowledge from proprietary backend systems, allowing agents to perform reasoning tasks across BigQuery and other cloud services without necessitating restrictive account-locked access.
- Role-Based Execution (Garry Tan): The "gstack" framework utilizes Markdown to define discrete "specialist roles." In this paradigm, the agent's logic is stored as structured prose rather than compiled binary code. By partitioning operational directives into individual files, the system enables modular agentic workflows where coding agents interpret and execute these instructions across various operational environments.
Technical Significance
The move toward Markdown represents a shift in the "AI moat" from raw model parameters to the accessibility and structure of context files. This methodology prioritizes:
- Interoperability: By avoiding binary formats, these systems ensure that any agent—regardless of its underlying architecture—can ingest and append data without conversion overhead.
- Context Management: This approach mitigates "context debt" by allowing agents to interact with long-term memory as a set of static files, leveraging the model’s linguistic strengths to manage file-based relationships () and hierarchical knowledge structures.
- Operational Transparency: Because the system configuration (as seen in gstack) is maintained as readable prose, it eliminates the "black box" nature of typical agentic logic, allowing for easier debugging and human oversight of the agent’s reasoning processes.
Ultimately, the article posits that for agentic workflows, the future of infrastructure is not found in complex runtime engines but in the efficiency of plain-text standards that allow AI agents to navigate and synthesize human-managed documentation.