這個頁面為你在建立使用者巨集的最佳實踐中包含了一些小技巧和建議。

為你的巨集新增一個簡短的描述

我們鼓勵你為你的巨集在 模板（Template ）新增一個備註的描述，可以參考下面的顯示的內容：

## Macro title: My macro name
## Macro has a body: Y or N
## Body processing: Selected body processing option
## Output: Selected output option
##
## Developed by: My Name
## Date created: dd/mm/yyyy
## Confluence version: Version it was developed for
## Installed by: My Name

## Short description of what the macro does

在巨集瀏覽器中展示你的引數

巨集瀏覽器是為你使用者使用配置你的巨集的最簡單的方式。你可以指定你的巨集的分類，圖示的連線定義在巨集瀏覽器中為使用者展示的資訊的引數等。

為巨集引數提供預設值

一般來說你不能保證使用者能夠完整的提供使用者的引數，一個讓巨集進行校驗是否收到了正確的引數的話，你可以在你的巨集中指定引數並在後面使用。

請參考下面的示例，在這個巨集中有 3 個引數，當用戶不提供引數的時候，這些引數的預設值將會被使用。

考慮安全提示

我們建議你為你定義的巨集進行一些許可權方面的測試。例如，限制頁面和空間許可權來避免沒有許可權的使用者可能的不經意間的顯示。請檢視 Writing User Macros 頁面中的內容。