dillinger

机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

Dillinger

你最终需要的 Markdown 编辑器。

一个现代的、云原生的 Markdown 编辑器，基于 Next.js 构建——专为速度、专注和无缝同步而设计。

入门 · 功能 · 集成 · 部署

✨ 为什么选择 Dillinger

大多数 Markdown 编辑器都是：

• 臃肿的
• 仅限离线
• 或者缺乏严肃的开发者体验

Dillinger 解决了这些问题。

它结合了：

• ⚡ VS Code 级别的编辑
• ☁️ 原生云存储
• 🧘 无干扰用户体验
• 🔄 实时渲染

⚡ 快速开始

npm install
npm run dev

Open → http://localhost:3000

🧱 要求

• Node.js 18
• npm / yarn / pnpm / bun

🚀 功能

编辑器体验

• Monaco 编辑器（VS Code 核心）
• Markdown 语法高亮
• 图片粘贴支持

实时工作流程

• 实时预览
• 滚动同步
• 即时反馈循环

专注模式

• Zen Mode (Cmd/Ctrl + Shift + Z)
• 全屏，无干扰写作

文件处理

• Drag & drop .md, .txt, .markdown
• 自动保存（本地持久化）

导出

• Markdown
• HTML
• PDF

云集成

• GitHub
• 谷歌云端硬盘
• Dropbox
• OneDrive
• Bitbucket

🔐 环境设置

创建：

.env.local

模板

# Google Drive
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=http://localhost:3000/api/google-drive/callback

# OneDrive
ONEDRIVE_CLIENT_ID=
ONEDRIVE_CLIENT_SECRET=
ONEDRIVE_REDIRECT_URI=http://localhost:3000/api/onedrive/callback

# Bitbucket
BITBUCKET_CLIENT_ID=
BITBUCKET_CLIENT_SECRET=
BITBUCKET_REDIRECT_URI=http://localhost:3000/api/bitbucket/callback

# GitHub
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GITHUB_REDIRECT_URI=http://localhost:3000/api/github/callback

# Dropbox
DROPBOX_CLIENT_ID=
DROPBOX_CLIENT_SECRET=
DROPBOX_REDIRECT_URI=http://localhost:3000/api/dropbox/callback

☁️ 云端集成

每个提供商都需要 OAuth 配置。

谷歌云端硬盘

• 启用云端硬盘 API
• 创建 OAuth 凭证
• 重定向：

/api/google-drive/callback

OneDrive

• Azure 应用注册

• 权限：

  • 文件.读写
  • 用户.读取

Bitbucket

• OAuth 消费者
• 仓库读写访问权限

GitHub

• OAuth 应用
• 回调：

/api/github/callback

Dropbox

• 受控应用

• 启用：

  • files.metadata.read
  • files.content.write

🚢 部署

更新所有 OAuth 回调：

https://yourdomain.com/api/{provider}/callback

然后：

npm run build
npm start

🏗 技术栈

📦 脚本

npm run dev              # Start dev server
npm run build            # Production build
npm start                # Start production server
npm run lint             # ESLint
npm run test             # Unit + E2E tests
npm run test:unit        # Vitest unit/integration tests
npm run test:watch       # Vitest watch mode
npm run test:e2e         # Playwright E2E tests
npm run test:e2e:headed  # E2E in visible browser
npm run verify           # Lint + typecheck + all tests

🧪 测试

294 个单元/集成测试（Vitest） 39 个端到端测试（Playwright），代码覆盖率为 98%.

npm run test:unit                # Run all unit tests
npx vitest run --coverage        # With coverage report
npm run test:e2e:headed          # E2E in visible browser

测试按类型组织在 tests/ 中：lib/、store/、hooks/、components/、routes/ 和 e2e/。

🧭 哲学

Dillinger 是围绕一个简单的理念构建的：

写作工具应该消失。

没有摩擦。没有杂乱。只有流畅。

🤝 贡献

欢迎提交 PR。重大更改请先开一个问题。

📄 许可证

麻省理工学院