Unstructured Content
Write natural language documentation, explanations, and narrative content in Markdown
Unstructured Content
Write natural language documentation, explanations, and narrative content in Markdown:
## Why Use MDX?
MDX allows you to **document your code** alongside the code itself.
You can use all standard Markdown features:
- Lists
- **Bold** and _italic_ text
- [Links](https://mdxld.do)
- Code blocks
- Images and media
- Tables
- And more...This content is human-readable, versionable in git, and can be transformed into HTML, PDF, or any other format. Markdown's simplicity makes it accessible to both developers and non-technical team members.
Why Markdown?
Markdown provides the perfect balance between:
- Simplicity: Easy to write and read in plain text
- Expressiveness: Rich formatting without complex syntax
- Portability: Works everywhere, version controllable in git
- Accessibility: Non-technical users can contribute
Standard Markdown Features
Text Formatting
**Bold text** and _italic text_
~~Strikethrough text~~
`Inline code` for technical termsLists
Unordered lists:
- Item one
- Item two
- Nested item
- Another nested item
Ordered lists:
1. First item
2. Second item
3. Third itemLinks and References
[Link text](https://example.com)
[Reference-style link][ref]
[ref]: https://example.comHeadings
# Heading 1
## Heading 2
### Heading 3
#### Heading 4Code Blocks
```typescript
function greet(name: string) {
return `Hello, ${name}!`
}
```Tables
| Feature | Description | Status |
|---------|-------------|--------|
| Frontmatter | Structured data | ✅ |
| Markdown | Unstructured content | ✅ |
| Components | UI elements | ✅ |Blockquotes
> This is a blockquote
> It can span multiple linesImages
MDX Extensions
MDX extends Markdown with additional capabilities:
Wikilinks
Create bidirectional links between documents:
See [[Getting Started]] for an introduction.
Related topics: [[Business-as-Code]], [[Services-as-Software]]Frontmatter
Add structured metadata to any document:
---
title: My Document
date: 2025-10-27
tags: [documentation, mdx]
---JSX Components
Embed interactive components in your content:
<Callout type="info">
This is a callout component
</Callout>Content Management
Version Control
MDX files work seamlessly with git:
git add docs/*.mdx
git commit -m "Update documentation"
git pushCollaboration
Multiple authors can collaborate on the same document:
- Pull requests for reviews
- Inline comments for feedback
- Diff tools show exact changes
- Merge conflicts are human-readable
Localization
Create translations by duplicating files:
docs/
├── en/
│ ├── index.mdx
│ └── getting-started.mdx
├── es/
│ ├── index.mdx
│ └── getting-started.mdx
└── fr/
├── index.mdx
└── getting-started.mdxUse Cases
Documentation
Write comprehensive guides and API documentation:
# Getting Started
Follow these steps to get started with the platform:
1. Install the SDK
2. Configure your environment
3. Create your first serviceTutorials
Create step-by-step tutorials with explanations:
## Step 1: Installation
First, install the package:
\`\`\`bash
pnpm install sdk.do
\`\`\`
This command will...Blog Posts
Write blog content with rich formatting:
---
title: Introducing MDX
author: Jane Developer
date: 2025-10-27
---
# Introducing MDX
Today we're excited to announce...Knowledge Bases
Build interconnected knowledge bases:
# Business-as-Code
[[Business-as-Code]] enables autonomous operations using:
- [[Services-as-Software]]
- [[Semantic Patterns]]
- [[Digital Workers]]