FeaturesTemplatesShowcaseTownie
AI
BlogDocsPricing
Log inSign up
dcm31

dcm31

simple_moirkdown_blog

Simple markdown blog template with moi.md integration
Public
Like
1
simple_moirkdown_blog
Home
Code
3
README.md
H
main.tsx
moi.md
Branches
1
Pull requests
Remixes
1
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 milliseconds.
Sign up now
Code
/
README.md
Code
/
README.md
Search
4/26/2025
Viewing readonly version of main branch: v5
View latest version
README.md

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.

FeaturesVersion controlCode intelligenceCLI
Use cases
TeamsAI agentsSlackGTM
ExploreDocsShowcaseTemplatesNewestTrendingAPI examplesNPM packages
PricingNewsletterBlogAboutCareersBrandhi@val.townStatus
X (Twitter)
Discord community
GitHub discussions
YouTube channel
Bluesky
Terms of usePrivacy policyAbuse contact
© 2025 Val Town, Inc.