Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mda.sno.dev/llms.txt

Use this file to discover all available pages before exploring further.

To start working with MDA, you’ll need:
  1. A basic understanding of Markdown
  2. A text editor for creating .mda files
  3. Optionally, the url2mda tool to convert web content to MDA format

​
Understanding MDA Components

MDA has three optional components that enhance standard Markdown:
  1. YAML Front Matter: Provides structured metadata (like title, doc-id).
  2. ai-script blocks: Embeds JSON instructions for AI/LLM processing.
  3. Footnotes with JSON: Defines typed relationships between documents (e.g., [^ref1]: `{"rel-type": ...}`). MDA Components
Each component is optional - use only what you need.

​
Creating a Simple MDA File

Create a file with the .mda extension. Here’s an example structure: 
---
doc-id: "example-123"
title: "My First MDA Document"
description: "A simple example of MDA format"
tags: ["example", "getting-started"]
created-date: "2024-06-10T10:00:00Z"
---

# Hello MDA

This is standard Markdown content.

(Your ai-script block would go here - see below)

This document is related to our documentation[^ref1].

[^ref1]: `{"rel-type": "related", "doc-id": "MDA-DOCS-UUID", "rel-desc": "Linked to the main MDA documentation"}`

​
Adding AI Instructions

Inside your .mda file, you can add an ai-script block like this: 
{
  "script-id": "summary-request",
  "prompt": "Summarize this document briefly.",
  "priority": "medium",
  "auto-run": true
}

​
Convert Web Content with url2mda

The easiest way to test MDA is with our url2mda service, which converts web pages to MDA format: 
curl -X POST https://url2mda.sno.ai/convert \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "subpages": false
  }'
Try it out in your browser: https://url2mda.sno.ai

​
Explore the Open Source Toolkit

MDA is fully open source and includes tools like url2mda that you can run locally:
  1. Clone the repository: git clone https://github.com/sno-ai/mda
  2. Navigate to the url2mda directory: cd mda/apps/url2mda
  3. Install dependencies: pnpm install
  4. Run locally: pnpm dev
View MDA examples in the docs/mda-examples directory to see MDA in action for various use cases. That’s it! You’re now ready to create AI-friendly content with MDA.