sec77/perlite

Perlite

镜像概述

Perlite是一款专为Obsidian笔记优化的基于Web的Markdown查看器，能够基于Obsidian文件夹（Vault）结构自动构建Web界面，无需手动解析或转换内容，帮助用户通过浏览器便捷地展示和访问Obsidian笔记。

核心功能与特性

• 基于文件夹（Vault）结构自动构建Web界面
• 支持Obsidian主题
• 完全响应式设计，适配各类设备
• 无需手动解析或转换笔记内容
• 提供全交互式图谱可视化
• 支持LaTeX公式和Mermaid图表渲染
• 可链接至Obsidian Vault
• 内置搜索功能
• 兼容Obsidian标签、内部链接和图片

演示

Perlite演示

!https://raw.githubusercontent.com/secure-77/Perlite/main/Demo/screenshot.png "演示截图"

!https://raw.githubusercontent.com/secure-77/Perlite/main/Demo/graph.png "图谱截图"

使用场景

• 个人Obsidian笔记的Web化展示与分享
• 团队内部Obsidian知识库的在线访问平台
• 无需复杂配置即可快速搭建的Obsidian笔记Web前端

使用方法与配置说明

Docker快速部署

通过以下命令启动Perlite容器，挂载本地Obsidian Vault目录：

bash
docker run -d -p 8080:80 -v /path/to/your/obsidian/vault:/app/vault --name perlite secure77/perlite

参数说明：

• -p 8080:80：将容器80端口映射至主机8080端口，通过http://localhost:8080访问
• -v /path/to/your/obsidian/vault:/app/vault：挂载本地Obsidian Vault目录至容器内/app/vault，Perlite将基于此目录构建Web界面
• --name perlite：指定容器名称为perlite

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  perlite:
    image: secure77/perlite
    ports:
      - "8080:80"
    volumes:
      - /path/to/your/obsidian/vault:/app/vault
    restart: unless-stopped

启动命令：docker-compose up -d

变更日志

https://github.com/secure-77/Perlite/blob/main/Changelog.md

名称由来

正如***所述：珍珠岩（Perlite）是一种无定形火山玻璃...通常由黑曜石（Obsidian）水合形成。 这一命名呼应了其为Obsidian笔记提供支持的核心定位。