AIA MatrixScan

Markdown Knowledge Base

The Markdown Knowledge Base is a directory of natural-language .md files — typically hosted at /markdown/ — that mirrors your Semantic Knowledge Graph in plain, human-readable prose rather than structured JSON.

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:

FormatBest For
JSON (/semantic/)Structured AI agents, APIs, schema validation
Markdown (/markdown/)LLM comprehension, conversational AI, readable prose

Check generated Markdown for clear structure, accurate facts, and consistency with the source website. The AIA Score methodology describes the signals measured by a scan.

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

A short factual summary may help a reader understand a page. Include only facts verified against the source website:

## 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].

Treat the summary as an optional convenience for readers and agents, not a guarantee that any AI system will cite the file.

File-by-File Reference

FilePurpose
index.mdDirectory overview, links to all other files, quick reference table
about.mdCompany story, founding, mission, team
services.mdDetailed breakdown of services or offerings
projects.mdCase studies and featured work with outcomes
testimonials.mdClient reviews, organized by theme
contact.mdAddress, hours, phone, email, service areas
faq.mdCommon questions in Q&A format

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 Search does not give Markdown files a special role in Search or AI Overviews. Publish useful content as accessible HTML for visitors and search engines. Markdown copies can serve agents and tools that choose to fetch them directly.

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 generates Markdown from scanned content. Review the generated facts and links before publishing, and regenerate files after meaningful website changes.

Related