1 files changed, 17 insertions, 15 deletions
diff --git a/docs/designers/language-modifiers/language-modifier-count-sentences.md b/docs/designers/language-modifiers/language-modifier-count-sentences.md
index 0a77ab82..dd2f69c6 100644
--- a/docs/designers/language-modifiers/language-modifier-count-sentences.md
+++ b/docs/designers/language-modifiers/language-modifier-count-sentences.md
@@ -1,37 +1,39 @@
-count\_sentences {#language.modifier.count.sentences}
-================
+# count_sentences
 
 This is used to count the number of sentences in a variable. A sentence
 being delimited by a dot, question- or exclamation-mark (.?!).
 
+## Basic usage
+```smarty
+{$myVar|count_sentences}
+```
 
-    <?php
+## Examples
+
+```php
+<?php
 
     $smarty->assign('articleTitle',
                      'Two Soviet Ships Collide - One Dies.
                      Enraged Cow Injures Farmer with Axe.'
                      );
 
-    ?>
-
-       
+```
 
 Where template is:
 
-
+```smarty
     {$articleTitle}
     {$articleTitle|count_sentences}
-
-       
+```
 
 Will output:
 
-
+```
     Two Soviet Ships Collide - One Dies. Enraged Cow Injures Farmer with Axe.
     2
-
+```
        
-
-See also [`count_characters`](#language.modifier.count.characters),
-[`count_paragraphs`](#language.modifier.count.paragraphs) and
-[`count_words`](#language.modifier.count.words).
+See also [`count_characters`](language-modifier-count-characters.md),
+[`count_paragraphs`](language-modifier-count-paragraphs.md) and
+[`count_words`](language-modifier-count-words.md).