diff --git a/docs/en/api-guides/tools/qemu.rst b/docs/en/api-guides/tools/qemu.rst
index 5d8836cc56..f05fd04f9c 100644
--- a/docs/en/api-guides/tools/qemu.rst
+++ b/docs/en/api-guides/tools/qemu.rst
@@ -166,6 +166,20 @@ The provided flash image must meet the following requirements for proper emulati
 - The flash file includes all required binaries, such as the bootloader, partition table, and application firmware, placed at their respective memory offsets.
 
 
+Passing Extra Arguments to QEMU
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Use the ``--qemu-extra-args`` option to pass additional arguments directly to QEMU. This is useful when you need to enable advanced QEMU features or debugging options. For example:
+
+.. code-block:: console
+
+    idf.py qemu --qemu-extra-args="-d in_asm,cpu" monitor
+
+This command starts QEMU with the specified extra arguments. You can use this option to pass any valid QEMU command-line arguments, such as enabling debug output, configuring devices, or other advanced features.
+
+For more available QEMU options, please refer to the `official QEMU documentation <https://www.qemu.org/docs/master/>`_ or run ``idf.py qemu --help``.
+
+
 Emulating Secure Boot
 ~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/zh_CN/api-guides/tools/qemu.rst b/docs/zh_CN/api-guides/tools/qemu.rst
index 20eade7ef9..5e199c75be 100644
--- a/docs/zh_CN/api-guides/tools/qemu.rst
+++ b/docs/zh_CN/api-guides/tools/qemu.rst
@@ -166,6 +166,20 @@ QEMU 支持 eFuse 的仿真，可用来测试安全启动和 flash 加密等与
 - flash 文件包括所有必需的二进制文件，如引导加载程序、分区表和应用程序固件，这些文件位于各自的内存偏移量处。
 
 
+传递额外参数给 QEMU
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+可以使用 ``--qemu-extra-args`` 选项直接向 QEMU 传递额外参数。这在需要启用 QEMU 的高级功能或调试选项时非常有用。例如：
+
+.. code-block:: console
+
+    idf.py qemu --qemu-extra-args="-d in_asm,cpu" monitor
+
+该命令会以指定的额外参数启动 QEMU。你可以通过此选项传递任何有效的 QEMU 命令行参数，例如启用调试输出、配置设备或其他高级功能。
+
+如需查看更多可用参数，请参考 `QEMU 官方文档 <https://www.qemu.org/docs/master/>`_，或运行 ``idf.py qemu --help``。
+
+
 模拟安全启动
 ~~~~~~~~~~~~~