Update rdoc

Readme.md

@@ -4,27 +4,32 @@
 
 ## Notes
 
-H2's support these:
+`h2` supports these:
 
     {: .-two-column}
     {: .-three-column}
     {: .-left-reference}
 
-H3's support these:
+`h3` supports these:
 
     {: .-prime}
 
-Tables support these:
+`table` supports these:
 
     {: .-shortcuts}
 
-Pre's support these:
+`pre` supports these:
 
     {: .-setup}
 
+`ul` supports these:
+
+    {: .-also-see}
+
 Each sheet supports these metadata:
 
 ```yml
+---
 title: React.js
 category: React
 layout: 2017/sheet   # 'default' | '2017/sheet'

rdoc.md

@@ -1,6 +1,7 @@
 ---
 title: Rdoc
 category: Markup
+layout: 2017/sheet
 ---
 
 ### Basic RDoc format
@@ -17,31 +18,45 @@ category: Markup
     # @see http://url.com
     #
     # @return [true] if so
-    #
+
+### Inline
+
+```
+*bold*
+_emphasized_
++code+
+```
+
+```
+http://www.link.com
+See Models::User@Examples
+{Google}[http://google.com]
+```
+
+### Skip
+
+```rb
+def input # :nodoc:
+```
+
+```rb
+module MyModule # :nodoc: all
+```
+
+### Definition lists
+
+```
 # == Definition lists
 #
 # list::  hi.
 # +foo+:: parameterized
-    #
+```
+
+```
 # == Definition lists
 # [foo]   also
 # [bar]   like this
-
+```
-### Inline
-
-    *bold*
-    _emphasized_
-    +code+
-
-    http://www.link.com
-    See Models::User@Examples
-    {Google}[http://google.com]
-
-### Skip
-
-    def input # :nodoc:
-
-    module MyModule # :nodoc: all
 
 ### Return types
 
@@ -65,17 +80,26 @@ category: Markup
 
 ### Sections
 
+```rb
 # :section: Expiry methods
 # methods relating to expiring
 
 def expire!
 def expired?
 ...
+```
 
 ### Using tomdoc
 
+```
 # :markup: TomDoc
-    # at the beginning ofthe file
+```
 
-http://rdoc.rubyforge.org/RDoc/Markup.html
+Plase this at the beginning of the file.
-http://www.rubydoc.info/gems/yard/file/docs/GettingStarted.md
+
+## Also see
+{: .-one-column}
+
+* <http://rdoc.rubyforge.org/RDoc/Markup.html>
+* <http://www.rubydoc.info/gems/yard/file/docs/GettingStarted.md>
+{: .-also-see}