用 Docmd 搭建我的新博客

最近想重新搭建我的个人博客，比较了几款静态站点生成器后，最终选择了 Docmd。

为什么是 Docmd？

1. 轻量快速

Docmd 生成的站点是纯静态 HTML，没有 React 的 hydration 负担：

• JS payload 仅 15KB
• 页面加载速度极快
• SEO 友好

2. 零配置

开箱即用，无需复杂配置：

npm install -g @docmd/core
docmd init
docmd build

3. 内置功能

• 🔍 离线全文搜索（无需 API key）
• 🌙 暗色模式支持
• 📝 代码高亮
• 🎨 多主题选择（sky、ruby、retro）

4. Markdown 原生

专注于内容，用熟悉的 Markdown 写作：

• 免费的 Mermaid 图表支持
• 标签 Tabs
• 步骤 Steps
• 卡片 Cards

搭建过程

1. 初始化项目

mkdir my-blog
cd my-blog
docmd init

2. 配置站点

编辑 docmd.config.js：

module.exports = {
  siteTitle: '我的博客',
  siteUrl: 'https://blog.example.com',
  srcDir: 'docs',
  outputDir: 'site',
  theme: {
    name: 'sky',
    defaultMode: 'system'
  }
};

3. 写作

在 docs/ 目录下创建 Markdown 文件：

---
title: 我的第一篇文章
date: 2026-02-12
---

# 文章标题

内容...

4. 构建部署

docmd build

生成的静态文件在 site/ 目录，可以直接部署到任何静态托管服务。

部署到 Nginx

简单的配置：

server {
    listen 443 ssl;
    server_name blog.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    root /path/to/site;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

总结

Docmd 是一个非常轻量、快速、易用的静态博客生成器，特别适合技术文档和个人博客。如果你也在寻找一个简单好用的静态站点生成器，不妨试试 Docmd！

💡 提示：Docmd 还支持 Live Editor，在浏览器中实时预览 Markdown！