diff --git a/cn/docs/tutorials/stateful-application/web.yaml b/cn/docs/tutorials/stateful-application/web.yaml
index f5f246c47f7e9..6c2770082bc8c 100644
--- a/cn/docs/tutorials/stateful-application/web.yaml
+++ b/cn/docs/tutorials/stateful-application/web.yaml
@@ -1,4 +1,3 @@
----
 apiVersion: v1
 kind: Service
 metadata:
diff --git a/cn/docs/tutorials/stateful-application/webp.yaml b/cn/docs/tutorials/stateful-application/webp.yaml
index 0a56f234e0cfc..74a71c90ac7b7 100644
--- a/cn/docs/tutorials/stateful-application/webp.yaml
+++ b/cn/docs/tutorials/stateful-application/webp.yaml
@@ -1,4 +1,3 @@
----
 apiVersion: v1
 kind: Service
 metadata:
@@ -42,4 +41,4 @@ spec:
       accessModes: [ "ReadWriteOnce" ]
       resources:
         requests:
-          storage: 1Gi
\ No newline at end of file
+          storage: 1Gi
diff --git a/cn/docs/user-guide/multi-pod.yaml b/cn/docs/user-guide/multi-pod.yaml
index 7f7d0a5745711..2ace060d89eff 100644
--- a/cn/docs/user-guide/multi-pod.yaml
+++ b/cn/docs/user-guide/multi-pod.yaml
@@ -1,4 +1,3 @@
----
 apiVersion: v1
 kind: Pod
 metadata:
diff --git a/docs/tasks/access-application-cluster/frontend.yaml b/docs/tasks/access-application-cluster/frontend.yaml
index 382c3786e5f8f..63631c0d05ede 100644
--- a/docs/tasks/access-application-cluster/frontend.yaml
+++ b/docs/tasks/access-application-cluster/frontend.yaml
@@ -1,5 +1,5 @@
-kind: Service
 apiVersion: v1
+kind: Service
 metadata:
   name: frontend
 spec:
diff --git a/docs/tutorials/stateful-application/web.yaml b/docs/tutorials/stateful-application/web.yaml
index 9f0ba1a343f5a..9b34869298905 100644
--- a/docs/tutorials/stateful-application/web.yaml
+++ b/docs/tutorials/stateful-application/web.yaml
@@ -1,4 +1,3 @@
----
 apiVersion: v1
 kind: Service
 metadata:
diff --git a/docs/tutorials/stateful-application/webp.yaml b/docs/tutorials/stateful-application/webp.yaml
index 231883742718d..705d1207cb13d 100644
--- a/docs/tutorials/stateful-application/webp.yaml
+++ b/docs/tutorials/stateful-application/webp.yaml
@@ -1,4 +1,3 @@
----
 apiVersion: v1
 kind: Service
 metadata:
@@ -45,4 +44,4 @@ spec:
       accessModes: [ "ReadWriteOnce" ]
       resources:
         requests:
-          storage: 1Gi
\ No newline at end of file
+          storage: 1Gi
diff --git a/docs/tutorials/stateful-application/zookeeper.yaml b/docs/tutorials/stateful-application/zookeeper.yaml
index f07708c398b93..952e5b45c5798 100644
--- a/docs/tutorials/stateful-application/zookeeper.yaml
+++ b/docs/tutorials/stateful-application/zookeeper.yaml
@@ -1,4 +1,3 @@
----
 apiVersion: v1
 kind: Service
 metadata:
diff --git a/docs/user-guide/environment-guide/backend-rc.yaml b/docs/user-guide/environment-guide/backend-rc.yaml
index 6c57b95dac912..28c7eeb097629 100644
--- a/docs/user-guide/environment-guide/backend-rc.yaml
+++ b/docs/user-guide/environment-guide/backend-rc.yaml
@@ -1,4 +1,3 @@
----
 apiVersion: v1
 kind: ReplicationController
 metadata:
diff --git a/docs/user-guide/environment-guide/backend-srv.yaml b/docs/user-guide/environment-guide/backend-srv.yaml
index 7083b37bf88e0..1c306bc0f60da 100644
--- a/docs/user-guide/environment-guide/backend-srv.yaml
+++ b/docs/user-guide/environment-guide/backend-srv.yaml
@@ -1,4 +1,3 @@
----
 apiVersion: v1
 kind: Service
 metadata:
diff --git a/docs/user-guide/environment-guide/show-rc.yaml b/docs/user-guide/environment-guide/show-rc.yaml
index 4de94c06ca30b..df2f03e3471c8 100644
--- a/docs/user-guide/environment-guide/show-rc.yaml
+++ b/docs/user-guide/environment-guide/show-rc.yaml
@@ -1,4 +1,3 @@
----
 apiVersion: v1
 kind: ReplicationController
 metadata:
diff --git a/docs/user-guide/environment-guide/show-srv.yaml b/docs/user-guide/environment-guide/show-srv.yaml
index 25a2d7473e021..17613104214cb 100644
--- a/docs/user-guide/environment-guide/show-srv.yaml
+++ b/docs/user-guide/environment-guide/show-srv.yaml
@@ -1,4 +1,3 @@
----
 apiVersion: v1
 kind: Service
 metadata:
diff --git a/docs/user-guide/multi-pod.yaml b/docs/user-guide/multi-pod.yaml
index 7f7d0a5745711..2ace060d89eff 100644
--- a/docs/user-guide/multi-pod.yaml
+++ b/docs/user-guide/multi-pod.yaml
@@ -1,4 +1,3 @@
----
 apiVersion: v1
 kind: Pod
 metadata:
diff --git a/test/examples_test.go b/test/examples_test.go
index 87b7e9a54a717..a7f837ae2c5a3 100644
--- a/test/examples_test.go
+++ b/test/examples_test.go
@@ -199,6 +199,10 @@ func walkConfigFiles(inDir string, fn func(name, path string, data [][]byte)) er
 			if err != nil {
 				return err
 			}
+			// workaround for Jekyllr limit
+			if bytes.HasPrefix(data, []byte("---\n")) {
+				return fmt.Errorf("YAML file cannot start with \"---\", please remove the first line")
+			}
 			name := strings.TrimSuffix(file, ext)
 
 			var docs [][]byte
@@ -217,7 +221,10 @@ func walkConfigFiles(inDir string, fn func(name, path string, data [][]byte)) er
 					if err != nil {
 						return fmt.Errorf("%s: %v", path, err)
 					}
-					docs = append(docs, out)
+					// deal with "empty" document (e.g. pure comments)
+					if string(out) != "null" {
+						docs = append(docs, out)
+					}
 				}
 			} else {
 				docs = append(docs, data)