Vowel

Markdown websites with superpowers

Vowel is a free, open source, zero-config website generator.

styles

/home.css

Why would you use it? Because it is fast and it makes websites that are also quite fast.

Why else would you use it? Because it's easy and it gives you the tools to do make all sorts of things.

Take a look at the code for a webpage:

Blog/Hello World.md

---
style: ./hello-world.css # Custom styles
atproto_lexicon: example.example.lexicon # AT Protocol publishing
---

# Hello World

January 3, 2022 <!-- Natural language date inferrence -->

#baking <!-- Tag pages -->

![Fresh baked cookies](./huge-image-file.jpeg) <!-- Image optimization -->
Fresh out of the oven. <!-- Image captions -->

This week I'm baking some cookies :icons/cookie:. <!-- Icon shortcodes -->

See my previous [[Cookie Recipes]]: <!-- Wikilinks -->

/recipes/cookies/* <!-- Glob listings -->

The recipe is based on one from my friend Suzy:

https://example-suzy.com <!-- Link embeds -->

Her cookies look beautiful:

![Suzy's cookies](https://cloudinary.com/suzy/cookie.jpg) <!-- CDN image optimization -->

Find special cookie tips on my [secret recipe page](/bonus-recipes##secret-key.md). <!-- Hidden pages -->

If you like my recipes, please [subscribe via RSS](/feed.xml)! <!-- RSS feed -->

Vowel runs with no config and one command:

# node@^26

cd your-website
npx vowel@latest

High standards

Vowel implements all of the modern best practices on the web, from GFM to a11y.

Forgettable syntax

Vowel makes most common operations so easy you'll feel like there's nothing new to learn.

Speed for need

Vowel builds your website in seconds, makes updates in milliseconds, and publishes to Cloudflare and atproto with a single command.

Friendly requests

Vowel integrates with the social web.

Free expression

Vowel takes care of the grunt work and lets you have fun with the creative parts.

Want to start building?

Proceed with the quickstart.