Article

Welcome to tommt.com

The site is now set up so each Markdown folder becomes a standalone article page automatically.

Welcome to tommt.com

This site is no longer just the default Astro starter.

When you add a new article, you do not need to edit routes or manually wire it into the listing page. Put it in the expected folder structure and the page is generated automatically.

Current conventions

  • One folder per article
  • The folder name becomes the article URL slug
  • The content file must be named index.md or index.mdx
  • Images live in the same folder as the article

Minimal example

src/content/blog/macbook-air-m4-review/
  index.md
  cover.jpg
  benchmark.png

That folder becomes:

/blog/macbook-air-m4-review/

Referencing images in Markdown

Use a relative path:

![Benchmark screenshot](./benchmark.png)

When to use MDX

For most articles, index.md is enough.

Only switch to index.mdx when you actually need Astro components inside the article body.