Skip to content
levybuildz

How This Site Publishes

The markdown frontmatter and workflow behind every post here. Edit or delete this — it exists as a working reference.

2 min read
  • markdown
  • workflow

Every post here is a single .mdx file in content/posts/. Commit it, push it, and the site rebuilds and ships on its own.

Frontmatter

The block at the top of this file is the frontmatter. Five fields are required:

FieldRequiredNotes
titleyesAlso becomes the URL slug
dateyesYYYY-MM-DD
descriptionyesUsed for SEO and link previews
categoryyesOne per post
tagsyesComma-separated, in one string
authoryeslevybuildz
statusnopublished, draft, or planned
testnotrue hides the post from every listing

A post with test: true is excluded from categories, tags, and authors. If every post is a test post, those lists come back empty and the static export fails — which is exactly what kept this site frozen for two years.

Writing

Standard markdown works, plus JSX if you want it.

const publish = (post: string) => `content/posts/${post}.mdx`

Blockquotes, tables, code fences, and math all render.

That's the whole system. Write the file, push it, done.