Core Concepts

Understand the fundamental concepts behind MarkdownAPI.io’s architecture and design.

Overview

MarkdownAPI.io is built around three core concepts:

• Projects - Containers for organizing files
• Files - Markdown and MDX documents
• Credits & Billing - Pay-per-use pricing model

Design Philosophy

1. Simplicity First

MarkdownAPI.io is designed to be simple and focused:

• Store markdown files
• Retrieve them later
• Organize with projects
• That’s it

2. AI-Native

Built specifically for AI agents and developers:

• Custom metadata for agent state
• Fast retrieval for context loading
• Batch operations for efficiency
• Simple API for agent integration

3. Pay-Per-Use

Fair pricing that scales with usage:

• No monthly minimums
• Pay only for what you use
• Credit-based system
• Auto-recharge available

Next Steps

• Projects - Learn about project organization
• Files - Understand file management
• Credits - Learn about pricing