无代码加密 无额外授权 版本号:1.0.3 适配PHP:7.4+
最近更新: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 为唯一内容来源的轻量文档站

使用步骤

  1. 在 emlog 后台启用插件,进入「插件 → 简单文档」
  2. 打开「基本设置」,填写文档站名称、副标题、简介,配置允许下载的扩展名与下载安全选项
  3. 打开「栏目管理」,按需建立栏目并排序
  4. 打开「文档管理」,点击「新建」,在线编写或导入 .md 文件,填写标题、简介并选择栏目
  5. 保存文档后,在编辑器下方上传附件
  6. 访问插件前台地址查看效果

常见问题

前台地址是什么? 默认为 /?plugin=lcbk_doc,开启伪静态后为 /plugin/lcbk_doc。文档详情、附件下载与预览使用其子路径。

为什么文档没有目录? 目录由正文中的 H2/H3 标题生成。请使用 Markdown 标题语法(如 ## 章节名),并确认「基本设置 → 文档内自动目录」为开启状态。

附件上传失败怎么办? 先检查文件扩展名是否在允许列表内,再确认文件大小未超过服务器 PHP 的 upload_max_filesize 与 post_max_size 限制。大文件建议先压缩。

前台访问 404? 请检查 emlog 后台「系统 → 设置 → SEO」中的伪静态配置是否已正确开启。

插件会生成静态文件吗? 不会。文档在每次请求时动态解析,渲染结果以内容哈希为键写入插件缓存目录,正文变化后自然失效。

说明

  • 附件上传上限同时受插件硬上限与 PHP 配置约束,取二者较小值
  • 数据表在插件启用时自动创建,升级时自动补齐新增字段
  • 删除插件会一并清理本插件创建的数据表与配置