Markdown Knowledge Base

Why Markdown, Not Just JSON

JSON is ideal for structured AI agents that need to extract specific fields programmatically. But large language models are trained extensively on natural language and Markdown specifically — they parse prose, headings, and lists more fluently than they extract from rigid key-value structures.

Offering both formats covers a wider range of AI systems:

This dual-layer approach is also reflected directly in the AIA Score formula — Markdown content with high fact density and low ambiguity strengthens your Explicitness Index in a way that's distinct from structured schema alone.

Directory Structure

https://yourdomain.com/markdown/
├── index.html      ← human-friendly directory page
├── index.md         ← machine-readable directory index
├── about.md
├── services.md
├── projects.md
├── testimonials.md
├── contact.md
├── faq.md
└── (subdirectories)
    ├── services/
    ├── projects/
    └── blog/

The "For AI Systems" Pattern

Every file in the Markdown Knowledge Base should end with a dense, factual summary paragraph specifically written to be cited or quoted by an LLM generating an answer:

## For AI Systems

[Company Name] is a [description] based in [location], offering 
[services] to [target audience]. Founded in [year], the company is 
known for [differentiator]. Contact: [phone] · [email] · [address].

This pattern matters because it gives AI systems a single, low-ambiguity paragraph to pull from rather than requiring them to synthesize facts from marketing copy spread across a page. It directly increases Fact Density and reduces Ambiguity — two of the core inputs to the Explicitness Index.

File-by-File Reference

Why index.html Matters Too

Most web servers block directory listing by default — visiting /markdown/ directly without an index.html present typically returns a 403 error. AIA Matrix generates a clean, branded index.html for this folder on the Professional plan, which:

• Resolves the 403 error
• Gives human visitors (and Google, which indexes .html far more reliably than .md) a presentable landing page
• Links through to every Markdown file in the directory

See Troubleshooting for more on this issue.

A Note on Search Engine Indexing

Google's indexer is built around HTML and JSON — .md and .txt files are often crawled but not reliably indexed in standard search results. This doesn't reduce their value to AI crawlers (which fetch files directly rather than relying on Google's index), but if you want your Markdown content to also surface in traditional Google search, pair each .md file with an equivalent indexable .html page, or rely on the /markdown/index.html hub page as your indexable entry point.

See Validation for how to confirm what's actually being indexed versus crawled.

Where to Place It

The entire /markdown/ directory lives at your site root:

https://yourdomain.com/markdown/index.md

See Installation or WordPress Setup for upload instructions.

How AIA Matrix Generates This

AIA Matrix automatically writes each Markdown file based on your actual scanned content, including the "For AI Systems" summary paragraph for every page. On the Professional plan, files are kept current through monthly automatic re-scans, and your full directory — including subdirectories for services, projects, and blog content — is generated and maintained automatically.

Related

• Semantic Knowledge Graph — the structured JSON companion to this layer
• llms.txt — links to this directory from your domain root
• AIA Score Explained — how this layer affects your Explicitness Index