Notes Site Starter

A personal site starter with a homepage (about, projects, experience), an MDX blog, and multi-source note sync (Apple Notes today) built with the Next.js App Router.

Everything this site publishes is plain server-rendered HTML or text. No JavaScript is required for agents, crawlers, or readers to see the homepage, the blog, the RSS feed, the sitemap, or the llms.txt index — and every page also speaks Markdown directly when requested with an Accept: text/markdown header, so AI tools can read content in the format they prefer.

What's inside

  • MDX content collectionsType-safe frontmatter with validation, drafts, and automatic slug, date, summary, and table-of-contents extraction.
  • GitHub Flavored Markdown and mathTables, task lists, footnotes, and KaTeX math render in every post, with Shiki syntax highlighting in code blocks.
  • Agent- and SEO-friendly outputServer-rendered HTML, an XML sitemap, an RSS feed, robots.txt, an llms.txt index, an OpenAPI description of the site, and Markdown content negotiation.
  • Dark mode and responsive layoutA small Tailwind CSS footprint, system dark mode, and a legible single-column reading layout.

Next steps

  • Developer docsEvery machine-readable endpoint, the content pipeline, and how to run the project.

  • Personalize guideA step-by-step checklist for turning a fresh clone into your own portfolio.

  • Deploy to VercelOne-click deployment with no configuration.

  • View sourceMIT-licensed source code, issues, and pull requests on GitHub.

Writing

  • Sync Test 1: Rich Text and ListsThis is the first paragraph. It should become the frontmatter summary, because the sync script picks the first non-heading text line as the summary.
  • Sync Test 2: Fenced Code BlocksThis note tests fenced code blocks. The triple-backtick fences below should become real fenced code in the generated MDX.
  • Sync Test 3: English LayoutThis note tests English layout: multiple paragraphs, emphasis, lists, and spacing. It has a longer first paragraph so the summary truncation logic can be…
  • Personalize Your Notes Site StarterA practical checklist for turning a fresh clone into your own portfolio, from identity and homepage data to writing, styling, machine-readable content, and deployment.
  • GitHub Flavored Markdown Rendering TestA compact rendering fixture for checking common Markdown and GitHub Flavored Markdown features in the MDX blog.

Projects

Experience

  • Acme StudioProduct Engineer

    2023 — Present