FeaturesTemplatesShowcaseTownie
AI
BlogDocsPricing
Log inSign up
dcm31
dcm31introducing_build_moi
Remix of dcm31/simple_moirkdown_blog
Public
Like
introducing_build_moi
Home
Code
3
README.md
H
main.tsx
moi.md
Branches
1
Pull requests
Remixes
History
Environment variables
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in miliseconds.
Sign up now
Code
/
README.md
Code
/
README.md
Search
4/26/2025
Viewing readonly version: 5
View latest version
README.md@5

Simple Markdown Blog for Val Town

A minimal, elegant markdown blog template for Val Town that works perfectly with build.moi.

Features

  • 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

How It Works

This template consists of just two files:

  1. main.tsx - The HTTP handler that renders your markdown content
  2. 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.

Getting Started

To use this template:

  1. Fork this project
  2. Edit the moi.md file with your own content
  3. That's it! Your blog is live

moi.md Structure

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...

Frontmatter Fields

FieldDescription
titleYour blog post title
descriptionBrief description that appears below the title
authorYour name (or pseudonym)
datePublication date in YYYY-MM-DD format
urlURL to your live blog (should be the HTTP endpoint from Val Town)
imageUrlCover image URL (2:3 aspect ratio recommended)
tagsArray of tags to categorize your post

Viewing in build.moi

When your blog is viewed through build.moi:

  1. In the Posts tab: Clicking on your blog will navigate directly to the live blog post
  2. 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

Customization

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.

Credits

Created by dcm31 on Val Town for use with build.moi.

Go to top
X (Twitter)
Discord community
GitHub discussions
YouTube channel
Bluesky
Product
FeaturesPricing
Developers
DocsStatusAPI ExamplesNPM Package Examples
Explore
ShowcaseTemplatesNewest ValsTrending ValsNewsletter
Company
AboutBlogCareersBrandhi@val.town
Terms of usePrivacy policyAbuse contact
© 2025 Val Town, Inc.