diff --git a/Documentation/guides/gdbwithpython.rst b/Documentation/guides/gdbwithpython.rst
new file mode 100644
index 00000000000..596c905e3f4
--- /dev/null
+++ b/Documentation/guides/gdbwithpython.rst
@@ -0,0 +1,27 @@
+====================
+GDB with Python
+====================
+
+Introduction
+============
+
+We can better debug the nuttx kernel through GDB's python extension.
+Some of the most common class usages are implemented under the nuttx/tools/gdb directory.
+Users can write their own python scripts to debug the nuttx kernel according to their needs
+
+Usage
+=====
+
+1. Compile nuttx with CONFIG_DEBUG_SYMBOLS=y
+2. Use gdb to debug nuttx elf.(real device, or sim, or coredump)
+3. add args to gdb command line: -ix="nuttx/tools/gdb/__init__.py"
+4. Then gdb will load the python script automatically.you can use the custom commands.
+
+How to write a GDB python script
+================================
+
+Here is an article to introduce, read it to understand the most basic principles of python,
+`Automate Debugging with GDB Python API <https://interrupt.memfault.com/blog/automate-debugging-with-gdb-python-api>`_.
+
+For more documentation on gdb pyhton, please refer to the official documentation of gdb
+`GDB with pyhton <https://interrupt.memfault.com/blog/automate-debugging-with-gdb-python-api>`_.
diff --git a/Documentation/guides/index.rst b/Documentation/guides/index.rst
index a669fd04292..f6e49584198 100644
--- a/Documentation/guides/index.rst
+++ b/Documentation/guides/index.rst
@@ -20,3 +20,4 @@ Guides
   nestedinterrupts.rst
   cortexmhardfaults.rst
   coredump.rst
+  gdbwithpython.rst