About This Site

关于 Marcos Notes

一个专为个人写作打造的轻量级 CMS 博客系统,致力于极致的创作流与沉浸式的阅读体验。

项目设计初衷

Core Philosophy & Motivation

传统的博客系统要么过于繁重(如 WordPress),要么缺少便捷的在线编辑与动态更新能力(如纯 Hexo/Hugo 静态站)。

Marcos Notes 采用了混合架构(Hybrid Architecture):

  • 极致的静态性能:面向读者的前端页面全部由 Next.js 进行静态预渲染(SSG),加载速度极快,且天然具备出色的 SEO。
  • 便捷的管理体验:后台通过 Vercel Blob 进行快速的草稿迭代、媒体上传与临时保存,提供像云笔记一样丝滑的编辑体验。
  • Git 级的内容版本控制:一旦内容确认发布,系统会将草稿自动编译成 Markdown 并同步至 GitHub 仓库,随后触发 Vercel CI/CD 管道重新生成静态页面。

技术栈与架构

Tech Stack & Infrastructure

⚡️ 前端渲染

Next.js + React (v19) + TypeScript。利用 React Markdown 提供灵活的高级排版,利用 Tailwind CSS v4 构建精致的视觉样式。

📦 媒体与草稿存储

使用 Vercel Blob 作为媒体和草稿的存储后端,完美承载图片资源和云端未发布草稿。

🔄 CI/CD 自动流

文章发布自动推送至 GitHub。通过 Webhook 触发 Vercel 自动化部署,实现从「编辑保存」到「全网公开」的端到端自动化。

🎨 卓越的编辑体验

内置左右分栏 Markdown 实时预览工作台,配备垂直粘性工具栏、快捷操作浮窗、快速图片上传和交互式新建分类功能。

后续演进路线

Future Roadmap & Ideas

支持从飞书、Obsidian 导出的 Markdown 文件进行智能高保真解析与导入。
文章版本历史管理:集成简洁的分支或修订历史回溯。
智能媒体资产管理:自动识别与清理未被引用的历史遗留图片。
自定义 MDX 增强组件:支持折叠面板、互动沙盒等更多丰富排版手段。