PowerWiki · v1.6.2

把 Git 仓库变成知识库

PowerWiki 把仓库里的 Markdown 和 HTML 变成可浏览、可分享的站点: 左侧查找文档,右侧定位章节,中间阅读正文。没有数据库,也没有后台, Git 仓库就是唯一的数据源——本站正是这样一个仓库。

01

v1.6.2 更新了什么

完整版本历史 →
1.6.2 2026-11-10 · Release
  • 普通 HTML 文章可滚动 没有沙箱标记的 HTML 文章不再套用沉浸布局,恢复整页滚动,不会再卡在第一屏。
  • 全屏行为分场景 这类文章的「全屏」直接打开完整页面;沙箱页面与 HTML 首页仍原地沉浸。
  • 沉浸式阅读保留 原地展开、首帧即沉浸与沙箱高度自适应等 v1.6.1 能力保持不变。
02

三分钟体验

全部演示 →

下面这些页面都来自同一个 Git 仓库。点开任意一篇,注意左侧目录、右侧章节和顶部工具栏。

  1. 01 阅读与分享 复制原文、切换原始视图、生成分享短链
  2. 02 HTML 页面演示 落地页、数据看板、WebGL、文档站与多页面站点,在隔离沙箱中运行
  3. 03 代码高亮 100+ 种语言语法高亮,一键复制,按语言跳转
  4. 04 时序图 Mermaid 图表按需渲染:流程图、时序图、甘特图、类图与 ER 图
  5. 05 本地图片 相对路径引用、点击查看大图,再切换暗夜模式看看
  6. 06 性能与缓存 更新何时生效、重复阅读如何复用缓存
03

核心能力

Markdown 与 HTML 一起收录

两种文章共用目录、复制、原始视图、分享短链、阅读数和 SEO 标签,不需要两套站点。

隔离沙箱

HTML 页面可以跑完整脚本与样式,但拿不到站点的 Cookie、localStorage 和同源接口。

双侧导航

左侧按仓库目录查找文档,右侧跟随当前文章章节,长文档也能快速定位。

沉浸式阅读

HTML 文章原地展开为全屏画布,Esc 退出;工具条另有全屏入口,可独立打开完整页面。

稳定地址与 SEO

slug 与 aliases 让链接在文件移动后依然有效;canonical、Open Graph、RSS 与 sitemap 共用同一地址。

Git 即数据源

定时拉取仓库,提交即发布;内容变化自动失效缓存,不需要数据库或管理后台。

04

快速开始

准备一个 Git 仓库,复制配置,一条命令启动。Node.js 22 LTS 或 Docker 均可。

# 克隆并启动
git clone https://github.com/steven-ld/PowerWiki.git
cd PowerWiki

cp config.example.json config.json
# 编辑 config.json,填入您的仓库地址

docker-compose up -d
# 打开 http://localhost:3150
05

相关链接

如果 PowerWiki 对您有帮助,请给项目一个 Star

源码在 GitHub, 镜像在 Docker Hub。 使用方式与案例可以继续看用户指南, 或回到关于页面了解项目本身。

Star on GitHub