内容形式

文档 Document

有排版结构的正文，文字中可以穿插图片、音视频等内容，适合完整、连贯的表达。

用于博客文章、知识库文档和图鉴介绍。

标题、作者及所属资源等信息保存在各自的业务表中，正文以 Markdown 文档存储；图片、音视频引用文件地址。

文档命名：默认版本使用“文档ID.md”，其他语言版本使用“文档ID.语言.md”，例如 guide.md、guide.zh-Hans.md、guide.ja.md、guide.en.md。

表情和提及通过资源坐标确定引用对象，格式为 {{kloudy://资源类型:资源项ID}}，例如 {{kloudy://character:hatsune_miku}}、{{kloudy://game:example_game}}、{{kloudy://emote:smile}}。emote 表示站内自定义表情，普通 Unicode Emoji 直接输入。代码区域按原文展示，不解析这些标记。

试用文章编辑器

输入 @ 插入行内资源；插入资源面板可切换大卡。仅在本页试用。

插入资源

正在听

推荐 アイドル，以及 初初音ミク。

初

初音ミク

初音未来

@hatsune_miku虚拟角色

片段 Snippet

纯文字与一组有序附件。图片、视频、音频和链接集中展示，不穿插在文字中，也不解析 Markdown。

用于博客动态、评论和普通聊天消息。聊天的会话、回复、撤回和已读状态由聊天模块管理；系统通知、工具调用结果等特殊消息保留各自的结构。

文字和附件列表保存在动态、评论或聊天消息所属的表中：content 保存原文，content_i18n 使用 JSON 列保存各语言的文字版本，attachments 保存有序附件列表；媒体引用文件地址。

content_i18n 与 attachments 使用 JSON 列，分别保存多语言文字和有序附件数组。片段直接保存在所属业务表中，多语言文字可选填，不要求每条聊天消息都有翻译。

文字中可以使用资源坐标提及角色、其他资源或插入表情，格式为 {{kloudy://资源类型:资源项ID}}；资源类型与资源项 ID 共同确定引用对象。普通 Emoji 直接保存。只解析专用标记，不启用 Markdown。

文本 Text

只包含文字，保留换行，不带附件，也不解析 Markdown 或 HTML 排版。

用于名称、标题、简介等文字字段；单语言和多语言使用同一种形式。

文字直接保存在所属资源的字段中，多语言版本用对应的 JSON 字段保存语言标签与文字的映射。

例如角色的 name_i18n、intro_i18n，歌曲的 title_i18n、intro_i18n。具体字段以资源类型为准。

资源的主要名称与标题使用原名。译名保存在对应语言的名称中，在保留原名的同时辅助展示；只显示一个名称时使用原名。

原名缺失时留空，不用译名、资源 ID 或“未命名”替代。创建或编辑资源时，先依据可靠来源确认原名，再分别填写已有依据的译名。

简介的不同语言版本介绍同一个资源。没有可核实的实质内容时可以留空，不用重复名称、类型或已有署名来填充。

name: "示例名称"
name_i18n: {
  "zh-Hans": "示例名称",
  "ja": "名前の例",
  "en": "Example name"
}