diff --git a/README.md b/README.md
index cca656c9d..5f946c1fc 100644
--- a/README.md
+++ b/README.md
@@ -766,7 +766,7 @@ selector. The types of arguments are varied. Some selectors support `String` or
```ruby
page.html # => '
- '
+ # '
# find by the element's [id] attribute
page.find(:id, 'greeting') == page.find_by_id('greeting') # => true
@@ -781,15 +781,15 @@ page.find(:field, 'content') == page.find_field('content') # => true
page.find(:field, 'Greeting') == page.find_field('Greeting') # => true
page.html # => '
-
- A |
- B |
-
-
- 1 |
- 2 |
-
-
'
+ #
+ # A |
+ # B |
+ #
+ #
+ # 1 |
+ # 2 |
+ #
+ # '
# find by content
page.find(:table_row, ['1', '2']) == page.find(:css, 'tr:last-of-type') # => true
diff --git a/lib/capybara/selector.rb b/lib/capybara/selector.rb
index 5c3d127dd..3f04cb05f 100644
--- a/lib/capybara/selector.rb
+++ b/lib/capybara/selector.rb
@@ -63,7 +63,7 @@
#
# ```ruby
# page.html # => '
-# '
+# # '
#
# page.find :field, 'article_title'
# page.find :field, 'article[title]'
@@ -79,8 +79,8 @@
#
# ```ruby
# page.html # => ''
+# #
+# # '
#
# page.find :fieldset, 'Fields (disabled)', disabled: true
# ```
@@ -152,7 +152,7 @@
#
# ```ruby
# page.html # => '
-# '
+# # '
#
# page.find :fillable_field, 'article_body'
# page.find :fillable_field, 'article[body]'
@@ -172,9 +172,9 @@
#
# ```ruby
# page.html # => '
-#
-#
-# '
+# #
+# #
+# # '
#
# page.find :radio_button, 'article_state_published'
# page.find :radio_button, 'article[state]', option: 'published'
@@ -194,7 +194,7 @@
#
# ```ruby
# page.html # => '
-# '
+# # '
#
# page.find :checkbox, 'registration_terms'
# page.find :checkbox, 'registration[terms]'
@@ -217,10 +217,10 @@
#
# ```ruby
# page.html # => '
-# '
+# # '
#
# page.find :select, 'article_category'
# page.find :select, 'article[category]'
@@ -240,8 +240,8 @@
#
# ```ruby
# page.html # => '
-#
-# '
+# #
+# # '
#
# page.find :option, 'General'
# page.find :option, 'General', selected: true
@@ -261,12 +261,12 @@
#
# ```ruby
# page.html # => '
-#
-# '
+# #
+# # '
#
# page.find :datalist_input, 'ice_cream_flavor'
# page.find :datalist_input, 'ice_cream[flavor]'
@@ -283,11 +283,11 @@
#
# ```ruby
# page.html # => ''
+# #
+# #
+# #
+# #
+# # '
#
# page.find :datalist_option, 'Chocolate'
# page.find :datalist_option, 'Strawberry'
@@ -304,7 +304,7 @@
#
# ```ruby
# page.html # => '
-# '
+# # '
#
# page.find :file_field, 'article_banner_image'
# page.find :file_field, 'article[banner_image]'
@@ -320,7 +320,7 @@
#
# ```ruby
# page.html # => '
-# '
+# # '
#
# page.find :label, 'Title'
# page.find :label, 'Title', for: 'article_title'
@@ -338,20 +338,20 @@
#
# ```ruby
# page.html # => '
-# A table
-#
-# A |
-# B |
-#
-#
-# 1 |
-# 2 |
-#
-#
-# 3 |
-# 4 |
-#
-# '
+# # A table
+# # |
+# # A |
+# # B |
+# #
+# #
+# # 1 |
+# # 2 |
+# #
+# #
+# # 3 |
+# # 4 |
+# #
+# # '
#
# page.find :table, 'A table'
# page.find :table, with_rows: [
@@ -378,19 +378,19 @@
#
# ```ruby
# page.html # => '
-#
-# A |
-# B |
-#
-#
-# 1 |
-# 2 |
-#
-#
-# 3 |
-# 4 |
-#
-#
'
+# #
+# # A |
+# # B |
+# #
+# #
+# # 1 |
+# # 2 |
+# #
+# #
+# # 3 |
+# # 4 |
+# #
+# # '
#
# page.find :table_row, 'A' => '1', 'B' => '2'
# page.find :table_row, 'A' => '3', 'B' => '4'