Appearance
Semantic Infrastructure as Readable Text
FreshThe philosophical foundation: how MD-LD transforms semantic systems into directly writable, inspectable, mergeable plain text. Explains the shift from "yet another RDF syntax" to "semantic-native infrastructure."
The Core Problem
Most software today uses graphs internally but hides them behind UIs:
- Notion, Slack, Google Docs — Human interfaces over hidden graphs
- CRMs, task apps, note apps — Proprietary data silos
- Social networks — Platform-controlled knowledge prisons
Users cannot access the graph directly. Semantics are hidden. Data is locked in products.
The problem is not that software uses graphs — the problem is that the graph is not exposed. You cannot write to the graph. You cannot inspect it. You cannot merge it with other graphs. You cannot reason about it. The platform mediates every interaction.
The MD-LD Approach
Traditional systems require:
Human → UI → App Logic → Hidden Database → APIs → ExportsMD-LD enables:
Human text → Graph immediatelyWriting becomes publishing. Publishing becomes graph construction. The document and the graph are two faces of the same knowledge.
What "Semantic Infrastructure" Means
The phrase "semantic infrastructure" refers to a substrate on which meaning can be built and exchanged without a controlling intermediary. Infrastructure implies:
- Persistence — information survives beyond a session
- Portability — information works outside the environment that created it
- Interoperability — different systems can exchange and combine the information
- Inspectability — any actor can read and verify the state
MD-LD satisfies all four: it lives in plain text files (persistence), can be opened in any text editor (portability), produces standard RDF quads (interoperability), and requires no rendering to understand (inspectability).
Why "Readable Text" Matters
The word "readable" is doing significant work here. RDF in general is "semantic infrastructure" — it solves the interoperability and inspectability problem at the machine level. But Turtle is write-only for most humans. JSON-LD requires a JSON parser. RDFa requires an HTML renderer.
MD-LD is the first RDF format that is natively readable — you do not need a renderer, a query engine, or a specialized tool to understand it. You can read it in a plain text editor, on paper, on a screen without a browser, over a network connection, in an SSH session, anywhere text can be displayed.
This is not a convenience feature. It is an architectural decision. Readable text is the most universal format that has ever existed. It outlasts platforms, survives migrations, works without internet access, and can be processed by tools that do not yet exist. A knowledge base in readable text is a knowledge base that survives.
The Annotations Are the Prose
The critical design decision in MD-LD is that annotations are not markup that wraps prose — they are extensions of prose that happen to carry semantic meaning.
Compare RDFa:
html
<span property="foaf:name">Alice</span>With MD-LD:
markdown
**Alice** {my:name}In RDFa, the semantic annotation encloses the text. In MD-LD, the annotation follows the text. This distinction matters: in MD-LD, stripping the {...} blocks produces valid, readable Markdown. The prose is not changed, not wrapped, not interrupted. The semantics are additive, not transformative.
Key Properties
Graph sovereignty — You own text, graph, provenance, execution, history. No platform controls your data.
No central platform required — Works offline, in browsers, on servers. A cloud service going down does not take your knowledge with it.
Universal semantic substrate — Agents can read, reason, write, execute, validate. The same format works for humans writing notes and for LLMs building knowledge bases.
Continuous semantic narrative — Unifies chat, tasks, notes, emails, calendar, files. A single document can contain journal entries, meeting notes, task lists, contact records, and validation shapes.
Native time dimension — Every action, statement, correction becomes part of the graph. The ledger pattern (append-only with retractions) encodes the history of knowledge, not just its current state.
Decentralized authority — RFC 4151 tag: URIs enable self-sovereign identity without central registries. Your IRI is yours by right of controlling the email address embedded in it.
Text-native agent memory — LLM Agent memory substrate in plain text. Parse context, write knowledge, merge with other agents, all as Markdown files. No database required.
Relationship to Existing RDF Formats
MD-LD does not replace Turtle, JSON-LD, or RDFa. It occupies a different position in the ecosystem:
| Format | Readable without renderer | Writable by humans | Machine-parseable | Round-trip safe |
|---|---|---|---|---|
| Turtle | With effort | Yes | Yes | Yes |
| JSON-LD | Rarely | With effort | Yes | Yes |
| RDFa | No | No | Yes | No |
| MD-LD | Yes | Yes | Yes | Yes |
MD-LD is the only format where all four columns are true. This combination is what makes it suitable as a semantic infrastructure — not just a serialization format, but a writing medium.