diff --git a/docs/tags/for.md b/docs/tags/for.md
index e8e19b3..9bb5540 100644
--- a/docs/tags/for.md
+++ b/docs/tags/for.md
@@ -21,7 +21,7 @@ Tag {for}
 `$first` равно **TRUE**, если итерация первая.
 `$last` равно **TRUE**, если итерация последняя.
 
-Поля <start>, <end>, <step> могут быть числами, или переменными, значение которых приводится к числовому.
+Поля `<start>`, `<end>`, `<step>` могут быть числами, или переменными, значение которых приводится к числовому.
 Значением параметров _index_, _first_, _last_ может быть только переменная (допускаются вложенности на подобии `$a.b.c`, но массив `$a.b` должен быть объявлен).
 
 
diff --git a/docs/tags/foreach.md b/docs/tags/foreach.md
index 718ca46..d9d48e3 100644
--- a/docs/tags/foreach.md
+++ b/docs/tags/foreach.md
@@ -1,13 +1,23 @@
 Tag {foreach}
 =============
 
-Перебор значений массива или итератора
+```smarty
+{foreach $list as [$key =>] $value [index=$index] [first=$first] [last=$last]}
+   {* ...code... *}
+   {break}
+   {* ...code... *}
+   {continue}
+   {* ...code... *}
+{foreachelse}
+   {* ...code... *}
+{/foreach}
+```
 
 ### {foreach}
 
 Перебор значений массива $list
 
-```smaert
+```smarty
 {foreach $list as $value}
  <div>{$value}</div>
 {/foreach}
diff --git a/docs/tags/if.md b/docs/tags/if.md
index 1a9f9b7..2b3a40d 100644
--- a/docs/tags/if.md
+++ b/docs/tags/if.md
@@ -1,7 +1,17 @@
 Tag {if}
 ========
 
-Реализация оператора if из PHP
+Реализация оператора [if](http://docs.php.net/if) из PHP
+
+```smarty
+{if <expression>}
+   {* ...code... *}
+{elseif <expresion>}
+   {* ...code... *}
+{else}
+   {* ...code... *}
+{/if}
+```
 
 ### {if}