diff --git a/docs/_posts/2017-02-11-vim8-new-feature-timers-zh_cn.md b/docs/_posts/2017-02-11-vim8-new-feature-timers-zh_cn.md
index 8a72ef692..0fbad9006 100644
--- a/docs/_posts/2017-02-11-vim8-new-feature-timers-zh_cn.md
+++ b/docs/_posts/2017-02-11-vim8-new-feature-timers-zh_cn.md
@@ -1,7 +1,7 @@
 ---
 title: "VIM 8 新特性之旅: 定时器 (timers)"
 categories: tutorials_cn
-excerpt: "VIM 8 新特性之旅系列教程 - 定时器"
+excerpt: "VIM 8 新特性之旅系列教程 - 定时器, 介绍定时器具体使用方法以及场景"
 ---
 
 ## 定时器（ timer ）
diff --git a/docs/blog.md b/docs/blog.md
index 9c099a4c6..679d1d156 100644
--- a/docs/blog.md
+++ b/docs/blog.md
@@ -1,5 +1,6 @@
 ---
 title: "Blog"
+description: "A list of latest blog about the feature of SpaceVim and tutorials of using vim."
 ---
 
 # Blog
diff --git a/docs/development/conventions.md b/docs/development/conventions.md
index 387783774..fd156defe 100644
--- a/docs/development/conventions.md
+++ b/docs/development/conventions.md
@@ -1,5 +1,6 @@
 ---
 title:  "Conventions"
+description: "conventions of contribute to SpaceVim, including the coding style guide about vim script and markdown"
 permalink: "/conventions"
 ---
 
diff --git a/docs/documentation.md b/docs/documentation.md
index fe4a5d4ca..b1a397c66 100644
--- a/docs/documentation.md
+++ b/docs/documentation.md
@@ -1,6 +1,6 @@
 ---
 title:  "Documentation"
-description: "A guide for using SpaceVim."
+description: "General documentation about how to using SpaceVim, including the quick start guide and FAQs."
 ---
 
 # SpaceVim Documentation
diff --git a/docs/layers/chat.md b/docs/layers/chat.md
index c3fb4567b..41e13a13f 100644
--- a/docs/layers/chat.md
+++ b/docs/layers/chat.md
@@ -1,3 +1,7 @@
+---
+description: "SpaceVim chatting layer provide chatting with qq and weixin in vim."
+---
+
 # [Layers](https://spacevim.org/layers) > chat
 
 SpaceVim chatting layer provide chatting feature in vim.
diff --git a/docs/layers/lang/javascript.md b/docs/layers/lang/javascript.md
index 7cdce7141..849ba6489 100644
--- a/docs/layers/lang/javascript.md
+++ b/docs/layers/lang/javascript.md
@@ -1,5 +1,6 @@
 ---
 title: "SpaceVim lang#javascript layer"
+description: "This layer is for JaveScript development"
 ---
 
 # [SpaceVim Layers:](https://spacevim.org/layers) lang#javascript
diff --git a/docs/layers/tags.md b/docs/layers/tags.md
index 18645f3e8..a7e61cc5d 100644
--- a/docs/layers/tags.md
+++ b/docs/layers/tags.md
@@ -1,27 +1,29 @@
 ---
 title: "SpaceVim tags layer"
+description: "This layer provide tags manager for project"
 ---
 
 # [SpaceVim Layers:](https://spacevim.org/layers) tags
 
 <!-- vim-markdown-toc GFM -->
-* [Description](#description)
-* [Features](#features)
-* [Install](#install)
-    * [GNU Global (gtags)](#gnu-global-gtags)
-        * [Install on OSX using Homebrew](#install-on-osx-using-homebrew)
-        * [Install on \*nix from source](#install-on-nix-from-source)
-            * [Install recommended dependencies](#install-recommended-dependencies)
-            * [Install with recommended features](#install-with-recommended-features)
-            * [Configure your environment to use pygments and ctags](#configure-your-environment-to-use-pygments-and-ctags)
-    * [Load tags layer](#load-tags-layer)
-* [Usage](#usage)
-    * [Language Support](#language-support)
-        * [Built-in languages](#built-in-languages)
-        * [Exuberant ctags languages](#exuberant-ctags-languages)
-        * [Universal ctags languages](#universal-ctags-languages)
-        * [Pygments languages (plus symbol and reference tags)](#pygments-languages-plus-symbol-and-reference-tags)
-* [Key bindings](#key-bindings)
+
+- [Description](#description)
+- [Features](#features)
+- [Install](#install)
+  - [GNU Global (gtags)](#gnu-global-gtags)
+    - [Install on OSX using Homebrew](#install-on-osx-using-homebrew)
+    - [Install on \*nix from source](#install-on-nix-from-source)
+      - [Install recommended dependencies](#install-recommended-dependencies)
+      - [Install with recommended features](#install-with-recommended-features)
+      - [Configure your environment to use pygments and ctags](#configure-your-environment-to-use-pygments-and-ctags)
+  - [Load tags layer](#load-tags-layer)
+- [Usage](#usage)
+  - [Language Support](#language-support)
+    - [Built-in languages](#built-in-languages)
+    - [Exuberant ctags languages](#exuberant-ctags-languages)
+    - [Universal ctags languages](#universal-ctags-languages)
+    - [Pygments languages (plus symbol and reference tags)](#pygments-languages-plus-symbol-and-reference-tags)
+- [Key bindings](#key-bindings)
 
 <!-- vim-markdown-toc -->