md.page

md.page is a powerful tool designed to convert Markdown files into visually appealing, shareable web pages effortlessly. This service enables users to publish content without the need for authentication, ensuring fast, hassle-free access to creating and sharing links. With md.page, users can simply make an API call to transform their Markdown documents into unique URLs that automatically expire after 24 hours.

Key Features

• Simple Publishing: Turn Markdown into web pages with a single command.
• User-Friendly Design: Enjoy clean typography, responsive layouts, and proper rendering of code blocks and tables.
• Minimal URL Management: Published pages receive concise, six-character URLs like md.page/a8Xk2m.
• Secure Sharing: Links are private and unguessable; only users with the specific URL can access the content.
• No Account Needed: Publish content instantly without having to create an account or handle API keys.
• AI Integration: Compatible with AI agents for seamless inclusion of publishing commands.

Usage Examples

Publish Markdown directly from the command line with ease, such as:

npx mdpage-cli README.md

This command publishes the document and provides a shareable link in seconds:

Published → https://md.page/a8Xk2m
Expires in 24h

For developers, the service offers an API endpoint to publish Markdown content programmatically:

curl -X POST https://md.page/api/publish \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Hello World\nYour markdown here..."}'

You will receive a JSON response with the shareable URL and the expiration time:

{
  "url": "https://md.page/a8Xk2m",
  "expires_at": "2026-03-28T12:00:00.000Z"
}

Self-Hosting Option

For users interested in having their instances, md.page can be deployed on Cloudflare Workers, making it easy to set up and manage your own Markdown publishing solution. A straightforward deployment process is outlined in the documentation, requiring only a basic understanding of Node.js and access to a Cloudflare account.

Technology Stack

md.page leverages cutting-edge technologies including Cloudflare Workers for execution and Cloudflare KV for storage, complemented by the efficient markdown-it library for optimal Markdown processing.

md.page streamlines the Markdown publishing process, enabling novices and experts alike to share their content quickly and efficiently.