diff --git a/docs/markdown/use-count-down.en-US.md b/docs/markdown/use-count-down.en-US.md
new file mode 100644
index 000000000..c19268ca5
--- /dev/null
+++ b/docs/markdown/use-count-down.en-US.md
@@ -0,0 +1,116 @@
+# useCountDown
+
+### Intro
+
+Used to manage the countdown.
+
+## Usage
+
+### Basic Usage
+
+```html
+Total time:{{ current.total }}
+Remain days:{{ current.days }}
+Remain hours:{{ current.hours }}
+Remain minutes:{{ current.minutes }}
+Remain seconds:{{ current.seconds }}
+Remain milliseconds:{{ current.milliseconds }}
+```
+
+```js
+import { useCountDown } from '@vant/use';
+
+export default {
+ setup() {
+ const countDown = useCountDown({
+ time: 24 * 60 * 60 * 1000,
+ });
+
+ countDown.start();
+
+ return {
+ current: countDown.current,
+ };
+ },
+};
+```
+
+### Millisecond
+
+```js
+import { useCountDown } from '@vant/use';
+
+export default {
+ setup() {
+ const countDown = useCountDown({
+ time: 24 * 60 * 60 * 1000,
+ millisecond: true,
+ });
+ countDown.start();
+
+ return {
+ current: countDown.current,
+ };
+ },
+};
+```
+
+## API
+
+### Type Declarations
+
+```ts
+type CurrentTime = {
+ days: number;
+ hours: number;
+ total: number;
+ minutes: number;
+ seconds: number;
+ milliseconds: number;
+};
+
+type CountDown = {
+ start: () => void;
+ pause: () => void;
+ reset: (totalTime: number) => void;
+ current: ComputedRef;
+};
+
+type UseCountDownOptions = {
+ time: number;
+ millisecond?: boolean;
+ onChange?: (current: CurrentTime) => void;
+ onFinish?: () => void;
+};
+
+function useCountDown(options: UseCountDownOptions): CountDown;
+```
+
+### Params
+
+| Name | Description | Type | Default Value |
+| --- | --- | --- | --- |
+| time | Total time, unit milliseconds | _number_ | - |
+| millisecond | Whether to enable millisecond render | _boolean_ | `false` |
+| onChange | Triggered when count down changed | _(current: CurrentTime) => void_ | - |
+| onFinish | Triggered when count down finished | - |
+
+### Return Value
+
+| Name | Description | Type |
+| ------- | ------------------- | ----------------------- |
+| current | Current remain time | _CurrentTime_ |
+| start | Start count down | _() => void_ |
+| pause | Pause count down | _() => void_ |
+| reset | Reset count down | _(time?: number): void_ |
+
+### CurrentTime Structure
+
+| Name | Description | Type |
+| ------------ | ----------------------------- | -------- |
+| total | Total time, unit milliseconds | _number_ |
+| days | Remain days | _number_ |
+| hours | Remain hours | _number_ |
+| minutes | Remain minutes | _number_ |
+| seconds | Remain seconds | _number_ |
+| milliseconds | Remain milliseconds | _number_ |
diff --git a/docs/markdown/use-count-down.zh-CN.md b/docs/markdown/use-count-down.zh-CN.md
index 1e9e0c41e..31361c6f7 100644
--- a/docs/markdown/use-count-down.zh-CN.md
+++ b/docs/markdown/use-count-down.zh-CN.md
@@ -39,7 +39,7 @@ export default {
### 毫秒级渲染
-倒计时默认每秒渲染一次,设置 millisecond 属性可以开启毫秒级渲染。
+倒计时默认每秒渲染一次,设置 millisecond 选项可以开启毫秒级渲染。
```js
import { useCountDown } from '@vant/use';
diff --git a/src/count-down/README.md b/src/count-down/README.md
index 5c794bb8d..9dd2000dd 100644
--- a/src/count-down/README.md
+++ b/src/count-down/README.md
@@ -130,7 +130,7 @@ export default {
| Attribute | Description | Type | Default |
| --- | --- | --- | --- |
-| time | Total time | _number \| string_ | `0` |
+| time | Total time, unit milliseconds | _number \| string_ | `0` |
| format | Time format | _string_ | `HH:mm:ss` |
| auto-start | Whether to auto start count down | _boolean_ | `true` |
| millisecond | Whether to enable millisecond render | _boolean_ | `false` |
@@ -160,7 +160,7 @@ export default {
| ------- | -------------- | -------------------------- |
| default | Custom Content | _currentTime: CurrentTime_ |
-### TimeData Structure
+### CurrentTime Structure
| Name | Description | Type |
| ------------ | ----------------------------- | -------- |
diff --git a/vant.config.js b/vant.config.js
index 5d905f11b..b20e3c409 100644
--- a/vant.config.js
+++ b/vant.config.js
@@ -822,10 +822,10 @@ module.exports = {
path: 'use-toggle',
title: 'useToggle',
},
- // {
- // path: 'use-count-down',
- // title: 'useCountDown',
- // },
+ {
+ path: 'use-count-down',
+ title: 'useCountDown',
+ },
// {
// path: 'use-rect',
// title: 'useRect',