跳转到主要内容
欢迎参与 Dify 文档的协同构建！本指南旨在阐述 Dify 开发者文档的贡献流程与规范，鼓励并协助社区成员共同提升文档质量。

​
更新现有文档

  • 推荐方式
  • 通过 URL 定位
在你希望修改的文档页面末尾，点击 编辑此页面 按钮。这将直接链接到 GitHub 上对应的源文件。
编辑时，请专注于正文内容的准确性和清晰度。文件头部的 Frontmatter 元数据及末尾的特定脚本或包含内容，通常由核心贡献者或通过自动化流程进行管理和维护。
如发现文档问题，你也可以通过页面上的 提交问题 按钮向我们报告。准确的问题反馈对社区和项目而言都是重要的贡献。

​
创建新文档

1

创建文件

在相应的语言目录下 (例如 plugin-dev-zh) 创建一个新的 .mdx 文件。

创建新文档

点击此卡片，直接在 GitHub 上创建文档。
初始文件名可自行定义 (例如 qwertyuiop12345678.mdx)，文件名必须足够长。
2

编写内容

请遵循标准的 Markdown 语法。在 MDX 文件中，注释请使用 JSX 风格：{/* 这是一个 MDX 注释 */}，而非 HTML 风格的 <!-- comment -->。
可适当运用 Mintlify 提供的组件优化内容结构与呈现：
<Note>
  这是一个重要提示。
</Note>

<Warning>
  这是一个警告信息。
</Warning>

<Card title="相关资源" icon="book">
  更多内容请参考相关资源...
</Card>
更多组件请参考 Mintlify 组件文档。
3

添加 Frontmatter (元数据)

每篇文档都需要定义 Frontmatter 元数据：
  • 正确配置的 Frontmatter 是确保文档能够被系统准确索引、排序并在文档网站上正确显示和导航的关键。
  • 你的首要任务是贡献高质量、准确的文档内容。
  • 如果你熟悉 Dify 的 文档 Frontmatter 元数据指南，我们非常欢迎你在提交时包含 Frontmatter。
  • 如果你不确定如何填写 Frontmatter，或者希望专注于内容创作，完全没有问题。 你可以提交不包含 Frontmatter 或仅包含部分元数据的 Pull Request。社区和项目核心贡献者会协助你进行后续的添加、审核与优化。
你的内容贡献至关重要。 即使你未提供完整的 Frontmatter，你的 Pull Request 依然受欢迎。确保文档最终拥有规范的元数据并成功集成，是社区与核心团队协作完成的工作。

​
提交你的贡献

完成编辑或创建新文档后，请通过 GitHub 向主仓库提交 Pull Request。社区成员和项目维护者将对你的贡献进行审阅。

​
常见问题解答

当然可以！文档贡献不需要编程技能。如果你对 Dify 有所了解，你可以帮助改进现有文档的清晰度、准确性，或添加更多用户友好的说明和示例。
确保你的内容清晰、准确，并遵循我们的格式指南。在提交前检查拼写和语法。如果不确定，可以在提交前在社区中讨论你的想法。
可以！我们欢迎多语言文档贡献。请确保你的文件放在对应语言的目录中，并在 Frontmatter 中正确标注语言代码。
感谢你为 Dify 社区和文档建设贡献力量！
编辑此页面 | 提交问题