Building with Jekyll, Hugo, Gatsby, or any Markdown-based system? The Lorem Ipsum Markdown API generates placeholder content in proper Markdown format with headings, lists, code blocks, and other common elements.
Why Markdown Lorem Ipsum?
Markdown has become the standard for content authoring in static site generators, documentation platforms, and many CMS systems. When testing these systems, you need placeholder content that is already in Markdown format.
The Lorem Markdown API saves you from manually converting plain text to Markdown, generating properly formatted content ready for your static site or documentation system.
Supported Markdown Syntax
The API generates content using standard Markdown syntax:
Headings
ATX-style headings from ## to #### (h2-h4)
Text Formatting
- **Bold text**
- *Italic text*
- `Inline code`
- [Links](url)
Lists and Blocks
- Unordered lists with -
- Ordered lists with 1.
- Blockquotes with >
- Code blocks with ```
Using the Lorem Markdown API
TinyFn provides a flexible endpoint to generate Markdown content:
GET https://api.tinyfn.io/v1/generate/lorem/markdown?paragraphs=4
Headers: X-API-Key: your-api-key
{
"markdown": "## Lorem Ipsum Dolor\n\nLorem ipsum dolor sit amet, **consectetur adipiscing** elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.\n\n- Ut enim ad minim veniam\n- Quis nostrud exercitation\n- Ullamco laboris nisi\n\nDuis aute irure dolor in *reprehenderit* in voluptate velit esse cillum dolore eu fugiat nulla pariatur.\n\n> Excepteur sint occaecat cupidatat non proident.",
"elements_used": ["h2", "p", "strong", "ul", "em", "blockquote"],
"word_count": 58
}
Parameters
| Parameter | Type | Description |
|---|---|---|
paragraphs |
integer | Base number of paragraph elements (1-20, default: 4) |
include_headings |
boolean | Include ## and ### headings (default: true) |
include_lists |
boolean | Include bulleted and numbered lists (default: true) |
include_code |
boolean | Include code blocks (default: false) |
include_frontmatter |
boolean | Include YAML frontmatter (default: false) |
Code Examples
JavaScript / Node.js
const response = await fetch(
'https://api.tinyfn.io/v1/generate/lorem/markdown?paragraphs=5&include_frontmatter=true',
{ headers: { 'X-API-Key': 'your-api-key' } }
);
const { markdown } = await response.json();
// Write to file for static site
require('fs').writeFileSync('content/sample-post.md', markdown);
Python
import requests
response = requests.get(
'https://api.tinyfn.io/v1/generate/lorem/markdown',
headers={'X-API-Key': 'your-api-key'},
params={
'paragraphs': 6,
'include_code': True,
'include_frontmatter': True
}
)
markdown_content = response.json()['markdown']
# Save as .md file
with open('docs/sample.md', 'w') as f:
f.write(markdown_content)
cURL
curl "https://api.tinyfn.io/v1/generate/lorem/markdown?paragraphs=4" \
-H "X-API-Key: your-api-key"
Common Use Cases
- Static Site Generators: Seed Jekyll, Hugo, Gatsby with sample posts
- Documentation Sites: Test Docusaurus, GitBook, or MkDocs layouts
- Markdown Editors: Test preview rendering in your editor
- Blog Themes: Preview theme designs with realistic content
- README Templates: Generate placeholder README content
Best Practices
- Use frontmatter for SSGs: Enable frontmatter for Jekyll/Hugo testing
- Include code blocks: Essential for documentation site testing
- Test all elements: Generate content with all Markdown features
- Check parser compatibility: Test with your specific Markdown parser
- Vary content length: Test with both short and long documents
Use via MCP
Your AI agent can call this tool directly via Model Context Protocol — no HTTP code needed. Add TinyFn to Claude Desktop, Cursor, or any MCP client:
{
"mcpServers": {
"tinyfn-generate": {
"url": "https://api.tinyfn.io/mcp/generate/",
"headers": {
"X-API-Key": "your-api-key"
}
}
}
}
See all generator tools available via MCP in our Generator MCP Tools for AI Agents guide.
Try the Lorem Markdown API
Get your free API key and start generating Markdown placeholder content.
Get Free API Key