Taildown

Write markdown. Get magic.

The markup language that transforms plain English into stunning, interactive web pages - zero configuration required.


What Is Taildown?

Taildown is a superset of Markdown that adds powerful features while maintaining full backwards compatibility. Write natural English styling instead of CSS classes, create interactive components with simple syntax, and compile to beautiful HTML + CSS + JavaScript.

Zero Config

Beautiful, professional styling out of the box. No setup, no configuration files, no webpack. Just write and compile.

What you get:

Plain English

Use natural language for styling - {large-bold primary center} instead of cryptic CSS classes.

Natural syntax:

Dark Mode Built-in

Every Taildown document includes automatic dark mode with system detection, localStorage persistence, and smooth transitions.

Features:


See It In Action

Example: Create a Beautiful Card

Write this:

:::card {light-glass padded-lg hover-lift}
## Welcome! {large-bold primary}

This card has glassmorphism, padding, and hover effects with **zero CSS**.

[Click Me](#){button primary hover-lift}
:::

Natural English. Readable. Powerful.


Core Features

Natural language replaces cryptic CSS classes

Instead of This Write This
.text-4xl .font-bold {huge-bold}
.bg-blue-600 .text-white {primary-bg}
.rounded-lg .shadow-xl {rounded-lg elevated}
.hover:translate-y-1 {hover-lift}

Everything reads like English. Everything makes sense.


Interactive Components

Zero-config tabs, accordions, modals, tooltips, and carousels

Tabs

Headings become tabs automatically:

:::tabs
## First Tab
Content for first tab
## Second Tab
Content for second tab
:::

Features:

Accordion

Bold text becomes triggers:

:::accordion
**First Section**
Content for first section
**Second Section**
Content for second section
:::

Features:

Carousel

Horizontal rules divide slides:

:::carousel
First slide

---

Second slide

---

Third slide
:::

Features:

Modals & Tooltips

Attach to ANY element:

[Click Me](#){button modal="Hello!"}

[Help](#){tooltip="Helpful tip"}

Features:


Why Taildown?

For You

For Your Projects


Perfect For

Documentation

Technical docs, API references, user guides

Landing Pages

Product pages, portfolios, SaaS sites

Blog Posts

Articles, tutorials, long-form content

Prototyping

Rapid mockups, design exploration


Quick Start

Get up and running in under 2 minutes:

Step 1: Install

# Via npm (coming soon)
npm install -g taildown

# Or clone repository
git clone https://github.com/vincitamore/taildown.git
cd taildown && pnpm install && pnpm build

Step 2: Create Document

Create hello.td:

# Hello World {huge-bold center primary}

Welcome to Taildown! {large center muted}

:::card {light-glass hover-lift}
## Your First Card {medium-bold}

Beautiful by default with zero configuration.

[Get Started](#){button primary hover-lift}
:::

Step 3: Compile

pnpm taildown compile hello.td

Output: hello.html- Self-contained, dark mode enabled, ready to deploy!


Real-World Examples

See what people are building with Taildown

This Documentation

This entire site is written in Taildown. View source to see how!

View Source

Plain English Guide

Comprehensive reference with tables, tabs, and examples.

View Example

Getting Started

Tutorial with interactive components and code examples.

View Example


Community & Support

Get Involved

GitHub

Star, fork, contribute

Repository

Discussions

Ask questions, share ideas

Join

Issues

Report bugs, request features

Open Issue

Documentation

Complete reference

Read Docs


Ready to build something beautiful?

Get started in 5 minutes. No configuration. No complexity. Just pure creative flow.