title:
My Simple MOIrkdown Blog
description:
A minimal markdown blog template for Val Town
author:
dcm31
date:
2025-04-26
url:
https://dcm31--45d1947422b711f0be5c569c3dd06744.web.val.run
imageUrl:
https://chatgpt.com/backend-api/public_content/enc/eyJpZCI6Im1fNjgwZDBjYzQxYTcwODE5MWFlZTZmNzhjZmJjNGVhNGQ6ZmlsZV8wMDAwMDAwMDU0MTg2MWY2YTRiOWMxOWE3NTA4Yjk5NCIsInRzIjoiNDg0OTEyIiwicCI6InB5aSIsInNpZyI6IjFhODc1NDE1ZjJkNmNlM2EwYjY4YjMzYmZhYTIwMDM2YmIzMWI5NjU2YWYzZTdkYmM2N2IxOWRmMzdlZjliYzIiLCJ2IjoiMCIsImdpem1vX2lkIjpudWxsfQ==
tags:
markdown
blog
val-town
template

Welcome to the Simple Markdown Blog Template

This minimal blog template allows you to create beautiful blog posts using just markdown in your moi.md file. It's designed to work seamlessly with the build.moi platform for Val Town.

How It Works

This blog automatically renders the content of your moi.md file. It supports all standard markdown features:

  • Headings (H1 through H6)
  • Lists (ordered and unordered)
  • Emphasis (bold, italic)
  • Code blocks (inline and fenced)
  • Links and images
  • Tables, blockquotes, and more

Features

The template includes several nice features:

  1. Clean, minimalist design focused on readability
  2. Responsive layout that looks great on any device
  3. Automatic dark mode that respects system preferences
  4. Metadata display for title, description, author, date, and tags
  5. Syntax highlighting for code blocks

YAML Frontmatter

The blog uses YAML frontmatter at the top of your moi.md file to configure your post. Here's what each field does:

--- 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"] ---

The url field is particularly important as it allows build.moi to link directly to your blog from the Posts tab.

Using This Template

To use this template for your own blog:

  1. Fork this project
  2. Edit the moi.md file with your content
  3. Deploy your blog on Val Town

Markdown Examples

Here are a few more markdown examples to show the styling:

Code Blocks

function greet(name) { return `Hello, ${name}!`; } console.log(greet('Val Town User'));

Blockquotes

The best way to predict the future is to invent it.

— Alan Kay

Tables

FeatureSupported
Headings
Lists
Code blocks
Images
Tables

Images

You can include images using standard markdown syntax:

Example image

Integration with build.moi

This template is designed to work perfectly with the build.moi platform. When your blog is displayed in the build.moi grid, it will:

  1. Show your cover image if you've provided one in the imageUrl field
  2. Link directly to your live blog instead of the code when viewed from the Posts tab
  3. Display a clean, formatted preview with your blog information

Next Steps

Feel free to modify this template to suit your needs. You can customize the styling by editing the main.tsx file or change the structure of your blog post by altering the moi.md file.

Happy blogging on Val Town!