# markdown 文档站

一个“只放 markdown、不做转换”的文档站：这里存放全部 `.md` 内容，由主机上的 nginx + njs 直接读取并在浏览器端渲染，磁盘上不生成任何 `.html` 中间文件。文件丢进来即可访问，改完即时生效。

## 目录里有什么

| 目录 | 内容 |
| --- | --- |
| `AI每日新闻/` | 每日 AI 行业资讯日报，按周归档（`2026年第XX周(MM-DD~MM-DD)/每日AI行业资讯日报_YYYY-MM-DD.md`） |
| `Famous每日介绍/` | 每日名人介绍（科学家、艺术家、历史人物等），同样按周归档 |
| `语种学习/` | 语言学习栏目，目前有 `英语/`：每日一篇高级英语学习文档（词汇 + 语法 + 句型 + 练习），按周归档 |
| `每日书籍介绍/` | 每日推荐一本书，含核心内容、摘录、适合人群与行动清单，按周归档 |
| `AI模型学习/` | 机器学习系统教程：导论、回归、树与集成、SVM/KNN/NB、聚类降维、深度学习、评估调参与端到端实战，共 7 篇 |
| `project/mdView/` | 文档站自身的使用说明（快速开始、语法示例、部署与运维） |
| `<栏目>/.workbuddy/` | 各栏目自动化任务的记忆/执行记录 |

## 内容是怎么来的

两个栏目都由 WorkBuddy 定时任务每天自动生成：检索当日信息 → 按固定模板成文 → 写入对应周目录。`.workbuddy/memory/*.md` 保留了每日的执行记录与“避重提示”，用于避免连续几天重复报道同一事件。

## 怎么访问

- 首页（卡片列表 + 关键词筛选）：`http://<主机IP>/md/`
- 单篇：`http://<主机IP>/md/AI每日新闻/2026年第43周(10-19~10-25)/每日AI行业资讯日报_2026-10-25.md`
- 看原始 markdown：在路径后加 `?raw=1`

## 技术组成

```text
/app/markdown/          文档目录（nginx 直接读取，对外 /md/）
/app/mdview/
  nginx.conf            /md/ 前缀、旧地址重定向、静态附件
  mdview.js             njs：目录出首页，.md 出渲染页
  assets/               marked.min.js / render.js / style.css
```

nginx 运行在主机上（systemd 管理，不用容器），`/mdview` 下的配置与前端资源由 nginx 直接引用，不做副本，避免两份配置漂移。