diff --git a/packages/opendesign/src/button/__docs__/index.en-US.md b/packages/opendesign/src/button/__docs__/index.en-US.md
index ed5592c72ce833795a3e2d9cc8e7999d6de0239f..c60c575f98f86ef74177ed7e2fca66d98152f18d 100644
--- a/packages/opendesign/src/button/__docs__/index.en-US.md
+++ b/packages/opendesign/src/button/__docs__/index.en-US.md
@@ -46,6 +46,8 @@ sidebar: OButton
 | \-\-btn-bg-color-disabled | Button background color in disabled state                            |
 | \-\-btn-radius            | Button border radius                                                 |
 | \-\-btn-gap               | Spacing between the button's preceding and following slots and text  |
+| \-\-btn-gap-prefix        | Spacing between button prefix slot and text (defaults to `--btn-gap`) |
+| \-\-btn-gap-suffix        | Spacing between button suffix slot and text (defaults to `--btn-gap`) |
 | \-\-btn-padding           | Button internal padding                                              |
 | \-\-btn-icon-size         | Size of text and icons in the button's preceding and following slots |
 | \-\-btn-height            | Button height                                                        |
diff --git a/packages/opendesign/src/button/__docs__/index.zh-CN.md b/packages/opendesign/src/button/__docs__/index.zh-CN.md
index 8d12109425ed7e91346bdc8470773d6b0f2f9427..b0327477e5c126882c2efb47722dc6b342e5d6ed 100644
--- a/packages/opendesign/src/button/__docs__/index.zh-CN.md
+++ b/packages/opendesign/src/button/__docs__/index.zh-CN.md
@@ -46,6 +46,8 @@ sidebar: OButton 按钮
 | \-\-btn-bg-color-disabled | 按钮禁用状态背景色                   |
 | \-\-btn-radius            | 按钮圆角                             |
 | \-\-btn-gap               | 按钮前后插槽与文本间距               |
+| \-\-btn-gap-prefix        | 按钮前插槽与文本间距，默认值为 `--btn-gap` |
+| \-\-btn-gap-suffix        | 按钮后插槽与文本间距，默认值为 `--btn-gap` |
 | \-\-btn-padding           | 按钮内边距                           |
 | \-\-btn-icon-size         | 按钮前后插槽文字及图标大小           |
 | \-\-btn-height            | 按钮高度                             |