加一篇新文章只要放个文件

不需要改代码。把 .md 文件放进对应科目文件夹，重新构建，首页和目录就会自动出现它。

1. 放哪

docs/
  accounting/     会计
  audit/          审计
  finance/        财管
  tax/            税法
  law/            经济法
  strategy/       战略
  interview/      面经
  data/           数据分析
  practice/       财会实操
  guide/          使用指南

比如新写一篇增值税进项抵扣的笔记：

docs/tax/input-vat.md

文件名用英文小写加连字符，URL 会变成 /notes/tax/input-vat。中文文件名也能用，但链接会变成一串编码，不好看。

2. 开头写 frontmatter

每个文件开头两行 --- 之间的部分：

---
title: 增值税进项税抵扣的五个坑
description: 一篇讲清楚哪些进项不能抵、什么时候转出。
date: 2026-10-30
category: 税法
tags: [增值税, 进项税]
sidebar_position: 3
---

字段	必填	作用
title	建议	卡片和目录显示的名字，不写就用文件名
description	建议	首页卡片上的一句话简介
date	建议	首页排序和「更新于」都用它，格式 2026-10-30
category	不用填	默认按文件夹自动归类，一般不用写
tags	可选	搜索和以后做标签页能用到
sidebar_position	可选	目录里的顺序，从 0 开始
draft: true	可选	加了就不会出现在站里（草稿）
cover	可选	自定义封面，比如 /img/covers/tax.svg

3. 正文随便写

支持的东西：

想写	写法
标题层级	# ## ###，会出现在右侧大纲
表格	标准 Markdown 表格
代码块	三个反引号 + 语言名（sql / python / bash）
图片	，图片放 static/img/
引用/提示	> 开头
行内公式	如 递延所得税 = 暂时性差异 × 税率（纯文本即可，暂不支持 LaTeX）

示例：

## 一、哪些进项不能抵

| 情形 | 能不能抵 |
| --- | --- |
| 用于集体福利 | 不能 |
| 非正常损失 | 不能 |
| 差旅住宿 | 能 |

> 记忆口诀：**个人消费、集体福利、非正常损失**，这三类拿到专票也别抵。

4. 加题目

题目放在 content/questions/ 里的 .yml 文件，一个科目一个文件：

subject: 税法
questions:
  - chapter: 增值税
    difficulty: 中
    type: 单选
    stem: 下列项目中，进项税额不得从销项税额中抵扣的是（　）。
    options:
      A: 购进的用于生产的原材料
      B: 购进的用于集体福利的货物
      C: 购进的用于销售的商品
      D: 支付的运输费用
    answer: B
    explanation: 用于集体福利的购进货物，进项税额不得抵扣。
    source: 教材例题改编

字段说明：

字段	必填	取值
subject	是	会计 / 审计 / 财管 / 税法 / 经济法 / 战略
chapter	是	章节名，随便起，会出现在筛选框里
difficulty	是	易 / 中 / 难
type	是	单选 / 多选 / 判断 / 简答
stem	是	题干
options	选择题必填	A: 内容 这样写，判断和简答不用
answer	是	单选用 B，多选用 [A, C] 或 AC，判断用 对/错，简答填参考答案要点
explanation	是	解析，答完立刻展示，一定要写
source	可选	来源，比如「2024 真题改编」

选择题的 options 也可以写成数组，元素带 A. 前缀会被自动识别。

5. 加面试卡

content/cards/interview.yml：

category: 会计岗
cards:
  - question: 收入确认的五步法是什么？
    answer: |
      1. 识别与客户的合同
      2. 识别合同中的履约义务
      3. 确定交易价格
      4. 分摊交易价格至各履约义务
      5. 在履约义务履行时确认收入
    tags: [收入, 新准则]
    level: 高频

6. 改完怎么看效果

npm start          # 本地预览，改文件自动刷新
npm run build      # 生成静态站（同时生成搜索索引）
npm run check      # 只检查内容有没有写错字段

放好文件后如果首页没更新，多半是 npm start 没在跑，或者文件放错了文件夹。