md2html (Markdown (GFM) to HTML API)

Note

This project is under active development. Feel free to open an issue for bugs or feature requests.

A powerful md2html (Markdown to HTML) converter service that transforms your Markdown content (GFM) into beautiful, feature-rich HTML. Built with modern technologies and support for advanced syntax features.

🚀 Quick Start

Installation

# Using npm
npm install

# Start development server
npm run dev

Basic Usage

// Client-side usage
const response = await fetch('https://localhost:3000', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/markdown'
  },
  body: '## Hello, World!'
});

const html = await response.text();

✨ Features

Core Markdown Support

• Complete GitHub Flavored Markdown (GFM)
  • Emoji Shortcodes: :smile: → 😄
  • Smart Autolinks: URLs automatically convert to clickable links
  • Syntax-highlighted Code Blocks
  • Tables with alignment options
  • Task Lists: - [x] (checked) and - [ ] (unchecked)
  • Strikethrough: ~~text~~
  • Extended Table Features

Enhanced Formatting

GitHub-Style Alerts

Note

This is a note

Tip

This is a helpful tip

Important

Critical information

Warning

Warning message

Caution

Proceed with caution

> [!NOTE]
> This is a note

> [!TIP]
> This is a helpful tip

> [!IMPORTANT]
> Critical information

> [!WARNING]
> Warning message

> [!CAUTION]
> Proceed with caution

Mathematical Expressions (KaTeX)

• Display Math: $$ ... $$ or \[ ... \]
• Inline Math: $ ... $
• Supports complex mathematical notations and equations
• Fast rendering with KaTeX

Advanced Code Blocks

Powered by Shiki, featuring:

• Rich syntax highlighting for 100+ languages
• Multiple beautiful themes
• Special annotations:

function hello() {
  console.log('Hello World!'); // [!code focus]
}

Advanced notation support:

• Diff highlighting: + for additions, - for deletions
• Line focusing: // [!code focus]
• Line highlighting: {1,3-5}
• Word highlighting: /pattern/
• Error/Warning levels: [!code error], [!code warning]

Additional Features

• Heading Anchors: Automatically generated, hoverable link icons
• Footnotes: Support for reference-style footnotes
• Table of Contents: Auto-generated based on headings
• Responsive Design: Looks great on all devices
• Custom Containers: For special content blocks
• Image Optimization: Lazy loading and size optimization

📄 License

MIT License © 2025-PRESENT Viki