diff --git a/autoload/SpaceVim/plugins/runner.vim b/autoload/SpaceVim/plugins/runner.vim
index ca587449b..a22ca3fd1 100644
--- a/autoload/SpaceVim/plugins/runner.vim
+++ b/autoload/SpaceVim/plugins/runner.vim
@@ -19,6 +19,22 @@
 "   q               close coder runner window
 "   i               insert text to background process
 " <
+"
+" @subsection defined a runner
+"
+" 1. The runner can be a string. which will be running directly.
+"
+" 2. The runner also can be a list with two items. each item has following
+" structure.
+"
+" >
+"   {
+"     "exe" : String,
+"     "opt" : a List of arguments,
+"     "targetopt" : String, the target option,
+"     "usestdin" : Bollean,
+"   }
+" <
 
 let s:runners = {}
 
diff --git a/doc/SpaceVim.txt b/doc/SpaceVim.txt
index d57a300ee..9e36a8693 100644
--- a/doc/SpaceVim.txt
+++ b/doc/SpaceVim.txt
@@ -6228,6 +6228,23 @@ KEY BINDINGS
   i               insert text to background process
 <
 
+DEFINED A RUNNER
+
+  1. The runner can be a string. which will be running directly.
+
+  2. The runner also can be a list with two items. each item has following
+structure.
+
+
+>
+  {
+    "exe" : String,
+    "opt" : a List of arguments,
+    "targetopt" : String, the target option,
+    "usestdin" : Bollean,
+  }
+<
+
 ==============================================================================
 TAB MANAGER                                      *SpaceVim-plugins-tabmanager*