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 documentationHumans 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
└── ModulesAn 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
- AuthorizationNow 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 pagesInstead 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
ReferencesThis 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 authorizationNotice 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
↓
LLMWith LLM Wiki:
LLM Wiki
↓
Chunking
↓
Embedding
↓
Vector Database
↓
Retriever
↓
LLMNotice 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
RoadmapAI 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.
