如何在这里写文章

这篇文章有两个用途:一是站点上线时的示例内容,二是我以后写新文章时的格式参考。真正开始写自己的东西后,可以照着它复制 front-matter。

Table of contents

新建一篇文章

在 src/content/posts/ 目录下新建一个 .md 或 .mdx 文件即可。文件名会成为文章 URL 的一部分:

src/content/posts/my-first-post.md        ->  /posts/my-first-post
src/content/posts/2026/hello.md           ->  /posts/2026/hello

以 _ 开头的目录不会被路由,适合放草稿或素材。

Front-matter 字段

每篇文章开头的 YAML 区块记录元数据。只有 title、description、pubDatetime 是必填:

---
title: 文章标题
description: 一句话摘要,会用在列表和 SEO
pubDatetime: 2026-07-22T10:00:00Z
author: tangmq          # 省略则用站点默认作者
featured: false          # 是否在首页「精选」区展示
draft: false             # true = 不发布
tags:
  - 标签一
  - 标签二
---

支持的写法

正文用标准 Markdown。标题从 ##(h2)开始——title 已经是页面的 h1。

代码块带语法高亮:

const greet = (name: string) => `你好,${name}`;

也支持 callout 提示框:

常用类型有 NOTE、TIP、WARNING、DANGER、INFO、SUCCESS 等,写法是 > [!类型] 加内容。

关于目录

想在文章里显示目录(TOC),只要在正文中写一个 ## Table of contents 的 h2 标题,构建时会自动生成——就像这篇文章顶部那样。