本文翻译自官方文档：https://confluence.atlassian.com/pages/viewpage.action?pageId=139387

Confluence宏

下面是Confluence中目前可用的宏列表。

单击宏名称可了解用法的详细信息，包括可选参数和示例。


通过宏（Macro），您可以将Confluence的能力提升到一个新的水平。

您可以使用宏来：

  • 更改页面的格式和布局
  • 显示视频、音频和社交媒体内容等
  • 整理和组织Confluence页面、博客和文件
  • 在页面执行操作，例如按模板创建页面



截图页面中包含：状态宏、页面属性报告宏、搜索宏和个人资料图片宏，它可帮助人们快捷查找有用的信息。

宏基础

在页面中添加宏

在页面中添加一个宏的步骤:

  1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
  2. 从列表中选择一个宏。
  3. 输入必要的参数。
  4. 点击插入（Insert）。

在编辑器中，您将看到一个代表宏的占位符。发布页面后，您将看到宏的全貌。

编辑宏

宏参数用于设置宏的行为。

要更改宏参数：

  1. 在编辑器中，点击宏占位符并选择“编辑（Edit）”。
  2. 根据需要设置参数，然后选择“插入（Insert）”。

有关每个宏中可用参数的完整详细信息，请参考以下每个宏的详细文档。

Confluence宏

下面是Confluence中目前可用的宏列表。

单击宏名称可了解用法的详细信息，包括可选参数和示例。



获取更多的宏

以上文档提供了Confluence中默认提供的所有宏的信息。您的Confluence中可能还有其它宏，来自第三方插件，或者可能是内部开发的。

第三方插件中的宏

您可以在插件市场中找到各种Atlassian和第三方提供的宏。它们作为插件发布，可以由Confluence管理员进行安装。

创建自己的宏

具有系统管理员权限的用户可以创建用户宏 - 请参阅编写用户宏。

如果您想创建更复杂的东西，您可以开发自己的插件 - 请参阅编写Confluence插件。

宏使用统计

Confluence管理员可以检查每个宏在您的站点中的使用频率。

查看宏使用频率，请前往

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

> 一般配置（General Configuration）  > 宏使用（Macro Usage）。这里列出了每个宏在空间中的使用频率，但不包括在归档空间中使用的任何宏或禁用的插件提供的宏。

未知的宏

在查看页面模式下，禁用的宏显示占位符图像：

当禁用带有正文内容的宏时，内容将被保留并显示在编辑器中。

要以查看模式显示正文内容：

  1. 在编辑器中，选择宏并点击编辑（Edit）。
  2. 在宏浏览器中，选择返回（Back）。
  3. 搜索并选择一个新的宏。
  4. 检查预览（Preview）窗口中显示的内容。
  5. 点击插入（Insert）。

在编辑器中，未知的宏将被替换为新的宏并显示您的内容。保存页面后就能在浏览模式下显示正文内容了。


扩展Confluence功能

在插件市场中的数百个宏中挑选一些来扩展 Confluence，例如：