Why one simple Markdown-based format might become the “HTML of AI knowledge”

“The next big innovation in AI may not be a new model, it may be a better way to feed knowledge into every model.”

Every few months, the AI community gets excited about a new foundation model.

GPT.

Claude.

Gemini.

Kimi.

Grok.

Llama.

But while everyone debates which model is smarter, faster, or cheaper, there’s another problem quietly becoming impossible to ignore:

Knowledge itself has no standard format.

Every company stores documentation differently. Every website structures information differently. Every AI agent has its own ingestion pipeline.

Every RAG system spends enormous effort cleaning data before an LLM can even understand it.

It’s surprisingly similar to the early days of the web, when every website had its own custom structure before HTML became the universal language.

That is exactly the problem Andrej Karpathy wants to solve with LLM Wiki. Instead of creating another AI model…

He proposed an open standard for AI-readable knowledge. It sounds simple. But simple ideas often change entire industries.

Let’s explore why.

What is LLM Wiki?

LLM Wiki is an open specification for writing knowledge in a format that Large Language Models can understand efficiently.

Think of it as:

  • Markdown for AI

  • HTML for LLM knowledge

  • Wikipedia optimized specifically for language models

Instead of designing documentation for humans first and AI second…

LLM Wiki designs documentation for both humans and AI simultaneously. The goal is beautifully simple:

One document should be readable by humans, searchable by machines, and directly understandable by language models.

Why Do We Even Need Another Format?

Let’s imagine you’re building an AI coding assistant. You want it to understand your company documentation. Sounds easy. Until you discover your documentation looks like this:

Website
 ├── Navigation
 ├── Sidebars
 ├── Advertisements
 ├── Popups
 ├── Cookie banners
 ├── Infinite scrolling
 ├── JavaScript widgets
 └── Actual documentation

Humans can easily ignore all the noise. LLMs cannot. Before an LLM can answer a single question, engineers often spend hours or even weeks building pipelines to:

  • scrape websites

  • remove HTML

  • clean formatting

  • split content

  • create embeddings

  • build vector indexes

  • maintain synchronization

Much of modern Retrieval-Augmented Generation (RAG) is actually solving a documentation formatting problem.

Karpathy’s proposal attacks the problem at its source. Instead of cleaning messy data later…

Create clean AI-ready knowledge from the beginning.

The Big Idea

LLM Wiki isn’t trying to replace Markdown. It extends familiar Markdown principles with conventions that make knowledge:

  • structured

  • deterministic

  • machine-friendly

  • easy to parse

  • easier for LLMs to navigate

Imagine Wikipedia articles written specifically so an AI never has to guess where information lives.

Every section has meaning. Every relationship is explicit. Every page becomes part of one giant knowledge graph.

Why Current Documentation Fails AI

Most documentation today was written for web browsers. Not language models.

For example:

Product Page
----------------------
Navigation
Sidebar
Search
Ads
Related articles
Comments
Footer
Legal
Privacy
Cookie popup
Actual content:
How OAuth works...

Humans mentally filter everything else. LLMs don’t naturally know what’s important.

This leads to:

  • hallucinations

  • missing context

  • inconsistent retrieval

  • poor chunking

  • wasted tokens

LLM Wiki dramatically reduces this ambiguity.

Core Principles of LLM Wiki

Although intentionally lightweight, the proposal is built around several key ideas.

1. Plain Text First

No JavaScript. No CSS. No complex HTML.

Just text.

Plain text is:

  • portable

  • version controllable

  • searchable

  • diff-friendly

  • future-proof

It also avoids unnecessary token waste.

2. Hierarchical Knowledge

Instead of scattered pages, knowledge becomes organized like a tree.

Example:

JavaScript
 ├── Variables
 ├── Functions
 ├── Closures
 ├── Promises
 ├── Async Await
 └── Modules

An LLM instantly understands relationships. Humans do too.

3. Explicit Linking

Instead of relying on vague hyperlinks, pages explicitly reference related concepts.

For example:

OAuthRelated:
- JWT
- OpenID Connect
- Authentication
- Authorization

Now an AI understands semantic relationships instead of merely seeing URLs.

4. Metadata Matters

Every document includes structured metadata.

For example:

Title
Summary
Tags
Updated date
Aliases
References
Related pages

Instead of forcing an LLM to infer context…

The author simply provides it.

5. AI-Friendly Sections

Rather than giant paragraphs, knowledge is broken into meaningful sections.

Example:

Definition
Problem
Solution
Examples
Best Practices
Pitfalls
References

This dramatically improves retrieval quality.

What Makes It Different from Markdown?

Markdown focuses on formatting. LLM Wiki focuses on knowledge representation.

Markdown asks:

“How should this look?”

LLM Wiki asks:

“How should an AI understand this?”

That’s a completely different design philosophy.

💡 Enjoying this article?
Every week day, I publish practical, production-ready deep dives covering Web development, System Design, Open source projects, Tech industry trends and AI Engineering and tools.

Example

Traditional Markdown:

# OAuth
OAuth lets users sign in using another service.
More information below...

LLM Wiki style:

Title: OAuth
Summary:
Authorization framework allowing applications
to access resources without sharing passwords.
Related:
- JWT
- OAuth2
- OpenID Connect
Examples:
- Google Login
- GitHub Login
Pitfalls:
- Confusing authentication with authorization

Notice how the second example is significantly easier for both humans and AI.

Why Developers Should Care

Most developers assume better AI comes from larger models. Reality is different. Better inputs often matter more than better models.

Garbage in. Garbage out.

Structured knowledge in. Better reasoning out.

Whether you’re building:

  • AI chatbots

  • coding assistants

  • documentation tools

  • internal copilots

  • enterprise search

  • customer support bots

the quality of your documentation directly affects model quality.

LLM Wiki and RAG

This might be where LLM Wiki becomes truly powerful. Today’s RAG pipeline usually looks like this:

Documents
↓
Cleaning
↓
Chunking
↓
Embedding
↓
Vector Database
↓
Retriever
↓
LLM

With LLM Wiki:

LLM Wiki
↓
Chunking
↓
Embedding
↓
Vector Database
↓
Retriever
↓
LLM

Notice something? Entire preprocessing stages disappear. Less engineering. Lower costs. Higher accuracy.

Enterprise Benefits

Imagine a company with:

  • 20,000 documentation pages

  • Confluence

  • SharePoint

  • PDFs

  • Notion

  • GitHub Wikis

  • Internal blogs

Every source has different formatting. Now imagine gradually converting important documentation into LLM Wiki.

Immediately you gain:

  • consistent retrieval

  • easier indexing

  • predictable chunking

  • cleaner embeddings

  • simpler AI pipelines

That’s a massive operational improvement.

Open Source Could Benefit Even More

Imagine every GitHub repository including:

/llmwiki
Installation
Architecture
APIs
Examples
FAQs
Known Issues
Roadmap

AI coding assistants would instantly understand repositories without elaborate scraping.

That could dramatically improve code generation quality.

Education Could Change Too

Educational content is currently fragmented across:

  • blogs

  • PDFs

  • documentation

  • lecture notes

  • tutorials

  • forums

LLM Wiki offers a consistent structure for learning material.

Students.

Teachers.

AI tutors.

Everyone benefits from the same organized knowledge.

A Small Standard With Big Potential

Many transformative technologies started as simple standards.

HTML standardized web pages. Markdown standardized technical writing. JSON standardized data exchange. OpenAPI standardized REST APIs.

Could LLM Wiki become the standard for AI knowledge? It’s too early to know.

But history repeatedly shows that shared standards often unlock entire ecosystems.

Limitations

LLM Wiki isn’t a magic solution.

It won’t replace:

  • databases

  • vector search

  • embeddings

  • reasoning models

  • knowledge graphs

Instead, it complements them. Organizations still need governance, versioning, and workflows.

The proposal also depends on community adoption. Without contributors, tooling, and integration into documentation platforms, it risks remaining an interesting idea rather than a widely used standard.

Why Karpathy’s Proposal Matters

Perhaps the most interesting part isn’t the specification itself. It’s the shift in thinking.

For years we’ve asked:

“How can AI understand our documents?”

Karpathy flips the question:

“How should we write documents so AI naturally understands them?”

That’s a subtle difference. But it changes everything. Instead of building increasingly complex preprocessing pipelines… 

We build better knowledge.

Final Thoughts

AI models are becoming commoditized. Knowledge quality is becoming the competitive advantage.

The companies that organize their information better will build smarter assistants, better copilots, more reliable RAG systems, and more capable AI products.

LLM Wiki is an early attempt to create that common language.

Whether it becomes the industry standard or simply inspires future formats, it highlights an important truth:

The future of AI isn’t only about building better models — it’s also about building better knowledge.

As developers, we spend countless hours optimizing prompts, tweaking embeddings, and experimenting with new models.

Perhaps the next breakthrough starts with something much simpler:

Writing knowledge in a way that both humans and AI can truly understand.

Thank You for Reading!

I hope you found it helpful and informative. If you have any questions or feedback, feel free to leave a comment below. Your support and engagement mean a lot to me.

Happy Coding!

Reply

Avatar

or to participate