marvinzhang.dev

Marvin Zhang's personal website and blog built with Docusaurus.

🚀 Features

Modern Blog: Built with Docusaurus blog theme
MDX Support: Write content in Markdown with React components
Responsive Design: Mobile-friendly and accessible
SEO Optimized: Proper meta tags and structured data
Dark Mode: Built-in dark mode support
Fast Performance: Powered by Docusaurus
Internationalization: Support for English and Chinese content

🛠️ Development

Prerequisites

Node.js 18+
npm or yarn

Installation

npm install

Development Server

npm run dev

Open http://localhost:3000 to view the site.

Build

npm run build

Start Production Server

npm run serve

✍️ Writing Blog Posts

Create a new .mdx file in the blog/ directory with frontmatter:

---
slug: my-post-slug
title: Your Post Title
authors: [marvin]
tags: ["tag1", "tag2"]
date: YYYY-MM-DD
---

# Your content here

Your blog post content in Markdown format.

For Chinese posts, create files in the i18n/zh/docusaurus-plugin-content-blog/ directory.

🎨 Customization

Theme Configuration

Edit docusaurus.config.ts to customize:

Site metadata
Navigation links
Footer content
Internationalization settings

Styling

The blog uses Docusaurus's built-in styling. For custom styles:

Edit src/css/custom.css
Add custom CSS classes and styles

🌐 Internationalization

The site supports both English and Chinese:

English posts go in the blog/ directory
Chinese posts go in the i18n/zh/docusaurus-plugin-content-blog/ directory
Use the language switcher to toggle between languages

🔗 Links

📄 License

MIT License - see LICENSE file for details.

Name	blog-tutorial
Description	Write step-by-step tutorial articles for marvinzhang.dev following 3-stage workflow (Outline → Writing → Refine). Use for how-to guides, implementation tutorials, and practical walkthroughs. Produces clear, actionable bilingual content with minimal code. Requires blog-common skill.

blog-tutorial

SKILL.md