diff --git a/source/docs/plugins/github-style-codeblock/index.markdown b/source/docs/plugins/github-style-codeblock/index.markdown
index 7639934..b7dbc49 100644
--- a/source/docs/plugins/github-style-codeblock/index.markdown
+++ b/source/docs/plugins/github-style-codeblock/index.markdown
@@ -12,19 +12,23 @@ for your code snippets, and then finish your code block with three more back tic
 
 #### Syntax
 
-    ``` language
-        code snippet
-    ```
+{% codeblock %}
+``` language
+    code snippet
+```
+{% endcodeblock %}
 
-### Example
+#### Example
 
-    ``` ruby
-        class Fixnum
-          def prime?
-            ('1' * self) !~ /^1?$|^(11+?)\1+$/
-          end
-        end
-    ```
+{% codeblock %}
+``` ruby
+    class Fixnum
+      def prime?
+        ('1' * self) !~ /^1?$|^(11+?)\1+$/
+      end
+    end
+```
+{% endcodeblock %}
 
 ``` ruby
     class Fixnum
@@ -35,4 +39,4 @@ for your code snippets, and then finish your code block with three more back tic
 ```
 
 This is a nice, lightweight way to add a highlighted code snippet. For features like titles and links you'll want to look
-at the `codeblock` or `include_code` liquid tags.
+at the [codeblock](/docs/plugins/code-block/) or [include_code](/docs/plugins/include-code/) liquid tags.
diff --git a/source/docs/plugins/video-tag/index.markdown b/source/docs/plugins/video-tag/index.markdown
index c8b1cd2..bdefc33 100644
--- a/source/docs/plugins/video-tag/index.markdown
+++ b/source/docs/plugins/video-tag/index.markdown
@@ -13,7 +13,10 @@ detect mp4 video support ([using Modernizr](http://modernizr.com)) and automatic
 
     {{ "{% video url/to/video [width height] [url/to/poster]" }} %}
 
-#### Demo
+#### Example
+
+    {{ "{% video http://s3.imathis.com/video/zero-to-fancy-buttons.mp4 640 320 http://s3.imathis.com/video/zero-to-fancy-buttons.png" }} %}
+
 
 {% video http://s3.imathis.com/video/zero-to-fancy-buttons.mp4 640 320 http://s3.imathis.com/video/zero-to-fancy-buttons.png %}