skills/mechanics/randomskill.md

-Mechanic: RandomSkill
-=====================
-
+## Description
 Executes a random skill from the list of supplied
 [skills](skills/mechanics/skill). Will ignore any skills that are on
 cooldown. There is no limit to how much skills can be added.
 
-Attributes
-----------
-
+## Attributes
 | Attribute | Aliases | Description                                             | Default |
 |-----------|---------|---------------------------------------------------------|---------|
 | skills    |         | The list of skills to execute, must be separated by a `,` |         |
 | fallbackskill | fbskill, fbs | the metaskill to run if condition checks fail for all skills in the randomskill list |
 
+## Weight
+You can also make your skills be executed with different chances via the weight system by simply adding a space and a number after the skill names. Skills without a weight will default to weight 1. The higher the number the higher chance that skill has for being picked.
 
+In this example SkillOne will have the highest chance of being picked, followed by SkillTwo, then SkillFour since it has the default weight of 1, then lastly SkillThree will have the lowest chance.
+```yaml
+Skills:
+- randomskill{skills=SkillOne 10,SkillTwo 0.5,SkillThree 0,SkillFour}
+```
 
-Examples
---------
-
-    Skills:
-    - randomskill{skills=skill1,skill2,skill3}
-
+## Examples
+```yaml
+Skills:
+- randomskill{skills=skill1,skill2,skill3}
+```
 Having problems overviewing your randomskill-syntax? Try this:
-
-    Skills:
-    - randomskill{
-        skills=
-        superskill,
-        green_skill,
-        skill3,
-        grandSkill,
-        7331
-        }
-
-You can also make your skills be executed with different chances via the weight system. Skills without a weight will default to weight 1.
-
-    Skills:
-    - randomskill{skills=metaskill 10,otherskill 0.5,someskill 0,testskill}
\ No newline at end of file
+```yaml
+Skills:
+- randomskill{
+    skills=
+    superskill,
+    green_skill,
+    skill3,
+    grandSkill,
+    7331
+    }
+```
\ No newline at end of file