# 文档中心

这里的所有 `.md` 文件**无需任何转换**，浏览器访问 nginx 的 `/md/` 就能看到渲染效果。

## 怎么用

1. 把 `.md` 文件丢进本目录（或任意子目录）
2. 浏览器打开 `http://<主机IP>/md/` —— 首页会列出全部文档卡片，支持关键词筛选
3. 直接敲路径也行：`http://<主机IP>/md/快速开始.md`
   - 看原始 markdown：`?raw=1`

新增、修改、删除文件即时生效，磁盘上不生成任何 `.html` 中间文件。

## 文档清单

- [快速开始](快速开始.md) — 3 分钟跑起来
- [语法示例](语法示例.md) — 支持哪些 markdown 写法
- [部署与运维](docs/部署与运维.md) — nginx 与首页的实现说明

## 首页长什么样

- 顶部渐变区：标题 + 文件/目录数量 + 最近更新时间 + 筛选框
- 卡片区：目录优先，文件按修改时间倒序；角标区分 MD / DIR / IMG / FILE
- 目录下若有 `README.md`，会渲染成首页正文，子目录页面同理

## 目录结构

```text
/app/markdown/          <- 文档目录（nginx 直接读取，对外 /md/）
/app/mdview/
  nginx.conf            <- nginx 配置（/md/ 前缀、重定向、静态附件），部署时复制到 /etc/nginx/nginx.conf
  mdview.js             <- njs：目录出首页，.md 出渲染页
  assets/               <- marked.min.js / render.js / style.css
```