ronmi/md-slider

md-slider镜像说明

镜像概述

md-slider是一款简单的Markdown转幻灯片工具，灵感来源于x/tool/present，支持将Markdown文件转换为可在线浏览的幻灯片，操作便捷且功能实用。

核心功能

1. Markdown转幻灯片：以一级或二级标题作为分页标记，自动生成幻灯片。
2. 元数据配置：支持设置标题、作者、***等必填信息，以及副标题、页脚等可选内容。
3. 演示者模式：通过URL参数开启，可查看幻灯片备注，提升演示体验。
4. 内部模式：启用后支持原始文件下载，适用于团队内部共享场景。

使用场景

• 个人快速制作演讲用幻灯片。
• 团队内部将文档转换为幻灯片进行分享。
• 轻量化场景下生成在线幻灯片。

配置说明

元数据设置

• 必填标签：TITLE（幻灯片标题）、AUTHOR（作者）、EMAIL（作者***）。
• 可选标签：FOOTER（每页底部文本）、SUBTITLE（标题副标题）、社交账号（/）、个人链接（URL）等。

演示者模式

在幻灯片URL后添加?present=enable开启，例如：http://127.0.0.1:9527/example.md?present=enable。

内部模式

启动容器时设置环境变量MD_SLIDER_INTERNAL_MODE=1，即可启用原始文件下载功能。

部署示例

Docker Run命令

bash
docker run -d --name slider -v /path/to/your/markdown/slides:/data -p 9527:8000 ronmi/md-slider

部署后访问http://127.0.0.1:9527查看幻灯片。

示例Markdown文件

markdown
#+TITLE: MD-Slider
#+SUBTITLE: Simple Markdown-to-slides converter inspired by x/tool/present
#+AUTHOR: Ronmi Ren
#+EMAIL: QAQ@example.com
#+URL: https://81k.today
#+TEXT: [81K Today](https://81k.today)
#+FOOTER: [MD-Slider](https://git.ronmi.tw/ronmi/md-slider)

# First page
## Second page
#+NOTE: my note
some text
- some
- list
- items
#+NOTE: another line of note

# Third page
some more text
#+NOTE: notes for page 3
![gopher](https://blog.golang.org/gopher/header.jpg)
[Copyright information of the gopher image](https://blog.golang.org/gopher)

许可证

本镜像基于GPLv3许可证发布。