最完整的Dillinger使用指南：从安装到高级功能全解析
【免费下载链接】dillinger The last Markdown editor, ever. 
项目地址: https://gitcode.com/gh_mirrors/di/dillinger
你是否还在为寻找一款既易用又功能强大的Markdown编辑器而烦恼？Dillinger作为一款云端支持、移动适配且兼容离线存储的编辑器，能够让你轻松实现Markdown编写、实时预览和多平台同步。读完本文，你将掌握从基础安装到高级插件配置的全部技巧，让Markdown编辑效率提升10倍。
什么是Dillinger？
Dillinger是一款基于AngularJS构建的HTML5 Markdown编辑器，被誉为"终极Markdown编辑器"。它提供实时预览功能，支持从GitHub、Dropbox等云存储服务导入导出文件，并能将Markdown转换为多种格式。项目核心代码位于app.js，采用模块化架构设计，通过plugins/目录实现功能扩展。
快速安装指南
系统要求
- Node.js v10+环境
- npm包管理器
基础安装步骤
git clone https://gitcode.com/gh_mirrors/di/dillinger
cd dillinger
npm install
node app
访问127.0.0.1:8080即可使用。生产环境部署可使用:
npm install --production
NODE_ENV=production node app
Docker部署方案
对于容器化部署，项目提供了完整的Dockerfile和docker-compose.yml配置:
docker build -t dillinger .
docker run -d -p 8000:8080 --name=dillinger dillinger
注意：PDF渲染功能需要添加
--cap-add=SYS_ADMIN参数
界面功能详解
Dillinger采用简洁直观的双栏布局，左侧为编辑区，右侧为实时预览区。主要界面组件包括:
核心功能使用技巧
实时预览与格式转换
编辑器默认开启实时预览，可通过点击右上角预览图标切换视图模式。支持导出为:
- HTML格式
- PDF文档
- 原始Markdown文件
导出功能通过documents-export.controller.js实现，可在"导出"菜单中选择所需格式。
文件管理功能
Dillinger提供多种文件操作方式:
- 本地文件拖放导入
- 通过文件选择对话框导入
- 自动保存到浏览器本地存储
文件管理核心逻辑位于documents.controller.js，支持文档创建、重命名和删除操作。
高级插件配置
Dillinger通过插件系统支持多种云服务集成，所有插件代码位于plugins/目录。
GitHub集成
- 在GitHub创建OAuth应用，获取Client ID和Secret
- 创建github-config.json配置文件:
{
"client_id": "YOUR_ID",
"client_secret": "YOUR_SECRET",
"redirect_uri": "http://localhost:8080"
}
- 通过环境变量也可配置认证信息:
github_client_id=YOUR_ID github_client_secret=YOUR_SECRET node app
Dropbox集成
- 在Dropbox开发者平台创建应用
- 配置dropbox-config.json:
{
"app_key": "YOUR_KEY",
"app_secret": "YOUR_SECRET",
"callback_url": "http://localhost:8080/oauth/dropbox"
}
其他云服务如Google Drive、OneDrive的配置方式类似，详细步骤可参考对应插件的README文档。
自定义与扩展
主题设置
Dillinger支持明暗两种主题，可通过设置面板切换。主题样式定义在theme-dillinger.js中，高级用户可修改SCSS样式文件自定义界面风格。
开发模式
如需扩展功能，可使用开发模式:
# 启动开发服务器
node app
# 启动构建工具
gulp watch
项目构建流程通过gulpfile.js定义，支持代码热重载和自动构建。
常见问题解决
本地存储丢失
如果浏览器清除了本地存储，可通过"文件"→"恢复"菜单尝试恢复最近文档。建议定期通过云服务同步重要文件。
PDF导出失败
确保Docker容器已添加SYS_ADMIN权限，或检查系统中是否安装了必要的PDF渲染依赖。
插件认证问题
云服务插件认证失败时，可删除对应配置文件并重新授权。详细错误信息可在浏览器开发者工具控制台查看。
总结与展望
Dillinger凭借其直观的界面设计和强大的功能集成，成为Markdown编辑的理想选择。无论是日常写作还是技术文档创作，都能显著提升效率。项目持续活跃开发，未来将支持更多云服务集成和高级编辑功能。
官方文档: README.md
插件开发指南: plugins/
贡献代码: 提交PR到项目仓库
希望本指南能帮助你充分利用Dillinger的全部功能。如有任何问题或建议，欢迎通过项目Issue系统反馈。
【免费下载链接】dillinger The last Markdown editor, ever. 项目地址: https://gitcode.com/gh_mirrors/di/dillinger
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
