Skip to main content
Meta1 min read

Legacy Markdown Support

Written by

Demonstrating support for standard .md files.

This post is written in a standard .md file, not .mdx.

Why support both?

Migration from other systems (Jekyll, Hugo) often involves thousands of .md files. Supporting them natively makes migration easier.

Footnotes

Footnote test1.

One of the main benefits of .md support is seamless migration. If you're moving from Jekyll, Hugo, or another static site generator, your existing posts can be dropped into the content/posts/ directory without any changes. Frontmatter fields like title, date, and tags are parsed identically for both formats.

The key difference is that .mdx files allow embedding React components directly in your content, while .md files stick to standard Markdown. For most blog posts, standard Markdown is more than sufficient — and keeping your content in .md means it stays portable across any Markdown-compatible system.

Code Block Test

javascript
console.log("Hello from .md file!");
  • Item 1
  • Item 2

References

This is a [link to markdown guide][md-guide].

Internal links: Home and Archives.

Reference links test: Markdown Guide, CommonMark.

markdown table

FeatureSumNotes
Tables> 10Requires remark-gfm
Task Lists5Checkboxes
Strikethrough1Deleted

Footnotes

  1. A simple footnote.

O

Written by

Old Timer