最近更新:1.0.3 1周前
- 新增
后台文档列表分页(每页 30)
后台写操作加入 CSRF 校验
- 修复
断点续传/流媒体重复计数下载
上/下篇无法跨栏目串联
阅读数刷新重复累加
搜索 % _ 被当通配符
一款将 Markdown 文档动态解析渲染为 HTML 文档页:基于 H2 自动生成 TOC 目录,支持上传 zip/pdf 等类型附件并记录下载日志,不生成任何静态 HTML 文件。适合搭建产品手册、使用教程、帮助中心、知识库等站点。
核心特性
渲染与阅读
- 正文使用 Markdown 编写,支持标题、列表、表格、引用、代码块、图片等常用语法
- 基于 H2/H3 标题自动生成两级目录,侧边固定展示,滚动时高亮当前章节
- 标题文字直接作为页内锚点(保留中文),正文可用
[跳转](#标题)直达对应章节 - 上一篇 / 下一篇按同一栏目内的排序自动串联,方便连续阅读
- 明暗主题一键切换并记住选择,跟随系统偏好作为默认值
栏目与检索
- 支持建立多个栏目,为文档指定所属栏目,前台首页按栏目分组浏览
- 栏目可重命名、调整排序,删除栏目时其下文档自动归入「未分类」
- 站内搜索同时匹配文档标题与正文,搜索与分页会保留当前栏目
附件与下载
- 文档保存后可上传多个附件,扩展名白名单可在后台自由配置
- 附件支持浏览器内直接预览:PDF、图片、音视频、txt、md
- 下载支持 HTTP Range 断点续传,大文件中断后可继续
- 可开启防盗链,仅允许从本站文档页访问附件
- 每次下载记录时间、文件名、来源 IP 与 User-Agent,并累计下载次数
日志与安全
- 下载日志支持按文档筛选与分页查看,可一键清空
- 可设置日志保留天数,访问日志页时自动清理过期记录
- php、phtml、phar、asp、jsp 等脚本类扩展名始终禁止上传
- 正文 HTML 经白名单净化,事件属性与危险协议被过滤
界面与体验
- 响应式布局,手机与桌面均有良好阅读体验
- 代码块自动识别语言,带语言标识与一键复制按钮,并进行轻量语法着色
- 自动生成页面标题、描述、canonical、社交分享标签与 Article 结构化数据,利于收录
- 提供跳到正文、返回顶部等无障碍与便捷入口
适用场景
- 产品说明书、软件使用教程
- 帮助中心、常见问题库
- 团队内部知识库、文档归档
- 以 Markdown 为唯一内容来源的轻量文档站
使用步骤
- 在 emlog 后台启用插件,进入「插件 → 简单文档」
- 打开「基本设置」,填写文档站名称、副标题、简介,配置允许下载的扩展名与下载安全选项
- 打开「栏目管理」,按需建立栏目并排序
- 打开「文档管理」,点击「新建」,在线编写或导入 .md 文件,填写标题、简介并选择栏目
- 保存文档后,在编辑器下方上传附件
- 访问插件前台地址查看效果
常见问题
前台地址是什么?
默认为 /?plugin=lcbk_doc,开启伪静态后为 /plugin/lcbk_doc。文档详情、附件下载与预览使用其子路径。
为什么文档没有目录?
目录由正文中的 H2/H3 标题生成。请使用 Markdown 标题语法(如 ## 章节名),并确认「基本设置 → 文档内自动目录」为开启状态。
附件上传失败怎么办?
先检查文件扩展名是否在允许列表内,再确认文件大小未超过服务器 PHP 的 upload_max_filesize 与 post_max_size 限制。大文件建议先压缩。
前台访问 404? 请检查 emlog 后台「系统 → 设置 → SEO」中的伪静态配置是否已正确开启。
插件会生成静态文件吗? 不会。文档在每次请求时动态解析,渲染结果以内容哈希为键写入插件缓存目录,正文变化后自然失效。
说明
- 附件上传上限同时受插件硬上限与 PHP 配置约束,取二者较小值
- 数据表在插件启用时自动创建,升级时自动补齐新增字段
- 删除插件会一并清理本插件创建的数据表与配置



评论一下吧
取消回复