Everkm Publish — Markdown 静态站点生成器

Everkm Publish

让你的知识,从 Markdown 走向世界

everkm-publish(毓知发布) 是 Everkm 生态下的 Markdown 静态站点生成器。

将你的笔记、知识库、产品文档、博客内容,通过主题渲染为高性能静态网站。

无需数据库,无需复杂部署。

写 Markdown,生成属于你的长期内容资产。


Markdown 内容
+
主题模板
↓
静态 HTML 网站
↓
CDN / 任意静态托管


适合构建什么?

场景用途
产品官网发布产品介绍、帮助文档、更新日志
技术文档构建 Wiki、开发手册、知识库
个人博客长期记录成长、经验与作品
内容站点发布结构化内容,获得搜索流量

从记录到发布

Everkm Publish 将:

  • 内容创作
  • 网站结构
  • 页面设计
  • 发布部署

完全分离。

你只需要:

  1. 使用 Markdown 编写内容
  2. 选择一个主题
  3. 本地预览效果
  4. 导出静态网站

写作
↓
组织知识
↓
生成页面
↓
搜索发现
↓
长期沉淀


核心能力

内容与主题分离

正文只负责内容。

页面结构、布局、样式由主题控制。

支持官方主题:

youlog

也可以:

  • fork 官方主题
  • 修改现有模板
  • 创建自己的主题

主题开发基于 Tera 模板引擎,兼容 Jinja2 语法。


灵活的网站结构

不同于传统博客固定结构:


首页
├── 分类
├── 文章
└── 页面

Everkm Publish 通过目录配置定义内容关系。

可以构建:

  • 产品文档
  • 知识地图
  • Wiki
  • 多层级资料库
  • 个人知识网站

站点结构由你的内容决定。

详见:

目录配置


毓知 Markdown

在标准 Markdown 基础上扩展:

  • [[页面]] 知识内链
  • 宏功能
  • dCard 内容卡片
  • _nav.md 章节导航

让 Markdown 不只是文章,而成为可连接的知识网络。

详见:


极速预览与静态导出

开发模式:

everkm-publish serve

实时预览内容变化。

发布:

everkm-publish serve --export

自动生成完整静态站点。

支持:

  • HTML 输出
  • 图片资源同步
  • 内链解析
  • 静态部署

部署到:

  • CDN
  • GitHub Pages
  • 任意静态托管服务

为搜索而生

内容只有被发现,才真正产生价值。

Everkm Publish 从生成到发布,全链路优化搜索体验。


SEO 友好的静态页面

导出结果:

  • 标准 HTML
  • 无运行时依赖
  • 搜索引擎可直接抓取

每篇 Markdown 支持:

title:
description:
keywords:

自动生成:

  • 页面标题
  • Meta 描述
  • 搜索摘要信息

站内全文搜索

官方主题支持:

Algolia

全文搜索能力:

  • 即时搜索
  • 多语言索引
  • 自动同步
  • CI 自动推送

让你的知识库拥有类似应用的搜索体验。

详见:

嵌入式搜索


多语言支持

内容按语言目录组织:

content/
zh_CN/
en_US/

配置文案支持:

@i18n:

轻松构建国际化站点。

详见:

多语言


主题生态

Everkm Publish 不限制网站形态。

支持:

  • 远程主题安装
  • 本地 ZIP 安装
  • 自定义模板
  • 站点扩展

主题可以随着你的内容一起成长。

详见:

主题开发


快速开始

安装:

brew install everkm/tap/everkm-publish

创建站点:

mkdir my-site

everkm-publish init my-site

cd my-site

启动预览:

everkm-publish serve

打开:

http://localhost:9081

开始构建你的第一个知识站点。


使用文档