你好,CodeLang:网站上线了

欢迎来到我的新网站!👋

这个网站是我为自己搭建的个人空间,用来记录技术笔记、项目心得与生活随想。

它是怎么工作的

整个系统非常简单:

  • Nginx 在最前端负责 HTTPS 与路由,/api/* 会被反向代理到后端的 Node.js 应用;
  • 所有文章都是服务器上的 Markdown 文件,没有任何数据库;
  • 每次访问时实时读取、实时渲染,因此推送到即生效,无需构建、无需重启。

怎么发布一篇新文章

在任意一台机器上,一行命令即可把本地 Markdown 推到网站:

curl -X PUT "https://codelang.xyz/api/articles/my-post-slug" \
  -H "Authorization: Bearer <你的Token>" \
  -H "Content-Type: text/markdown" \
  --data-binary @my-post.md

其中 my-post-slug 是文章的 URL 标识(支持英文、数字、中文)。文章顶部可以写 front matter 来指定元信息:

---
title: 文章标题
date: 2026-09-14
tags: 技术, 随笔
summary: 一句话摘要,会显示在列表页。
---

正文从这里开始……

不写 front matter 也可以:第一个 # 标题 会作为文章标题,文件时间为发布日期。

支持的其他接口

方法 路径 说明
GET /api/articles 文章列表(JSON)
GET /api/articles/:slug 单篇文章(含渲染后 HTML)
POST /api/articles 新建文章(已存在则返回 409)
PUT /api/articles/:slug 创建或覆盖文章
DELETE /api/articles/:slug 删除文章
PUT /api/pages/about 更新「关于」页

写接口都需要 Authorization: Bearer <Token> 认证。


更多玩法慢慢探索,欢迎常来逛逛。