A minimal, elegant markdown blog template for Val Town that works perfectly with build.moi.
- Minimalist design focused on content readability
- Dark mode support that adapts to system preferences
- Fully responsive for all devices
- No dependencies beyond the Val Town environment
- build.moi integration for showcasing your blog
- Markdown rendering with support for all standard features
- YAML frontmatter for metadata
This template consists of just two files:
- main.tsx - The HTTP handler that renders your markdown content
- moi.md - Your actual blog post content with frontmatter metadata
The main.tsx file loads your moi.md content, parses the frontmatter, and renders it as a beautifully styled blog post. It's designed to work perfectly with build.moi, which will display your blog as a post with a direct link to the live version.
To use this template:
- Fork this project
- Edit the moi.md file with your own content
- That's it! Your blog is live
Your moi.md file should have YAML frontmatter at the top followed by your markdown content:
---
title: "Your Blog Post Title"
description: "A brief description of your post"
author: "Your Name"
date: "YYYY-MM-DD"
url: "Your live blog URL"
imageUrl: "Cover image URL (2:3 ratio works best)"
tags: ["tag1", "tag2", "tag3"]
---
# Your blog content here
Write your blog post in markdown...
| Field | Description |
|---|---|
| title | Your blog post title |
| description | Brief description that appears below the title |
| author | Your name (or pseudonym) |
| date | Publication date in YYYY-MM-DD format |
| url | URL to your live blog (should be the HTTP endpoint from Val Town) |
| imageUrl | Cover image URL (2:3 aspect ratio recommended) |
| tags | Array of tags to categorize your post |
When your blog is viewed through build.moi:
- In the Posts tab: Clicking on your blog will navigate directly to the live blog post
- In the Code tab: Clicking will go to the source code
To ensure your blog appears in the Posts tab:
- Make sure you have a moi.md file at the root of your project
- Include the URL field in your frontmatter pointing to your live blog
You can customize the template by editing the main.tsx file:
- Modify the styling by changing the Tailwind CSS configuration
- Alter the layout by editing the BlogPost component
- Add new features like comments, analytics, etc.
Created by dcm31 on Val Town for use with build.moi.