欢迎来到我的新网站!👋
这个网站是我为自己搭建的个人空间,用来记录技术笔记、项目心得与生活随想。
它是怎么工作的
整个系统非常简单:
- 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> 认证。
更多玩法慢慢探索,欢迎常来逛逛。