diff --git a/.github/issue_template.md b/.github/issue_template.md
index 3f20273..64f7854 100644
--- a/.github/issue_template.md
+++ b/.github/issue_template.md
@@ -1,21 +1,30 @@
-<!-- The template below is for reporting bugs. For feature requests and others, feel free to delete irrelevant entries. -->
+// The template below is for reporting bugs. For feature requests and others, feel free to delete irrelevant entries.
 
-Platform: <!-- Example: Ubuntu Desktop 17.04 amd64 -->
+### Platform
+// Example: Ubuntu Desktop 17.04 amd64
 
-GPU, drivers, and screen setup: <!-- Example: NVidia GTX 670, nvidia-drivers 381.09, two monitors configured side-by-side with xrandr -->
+### GPU, drivers, and screen setup
+// Example: NVidia GTX 670, nvidia-drivers 381.09, two monitors configured side-by-side with xrandr
 
-Compton version: <!-- Example: 0.1~beta2+20150922-1 from the official repository -->
+### Compton version
+// You can run `compton --version` to get that
+// Example: v1
 
-Compton configuration: <!-- Put the configuration on your preferred pastebin service and place the link here, or directly paste it to the bottom of the issue. -->
+### Compton configuration:
+```
+// Paste your configuration here
+```
 
 ### Steps of reproduction
+// If you can reliably reproduce this bug, please describe the quickest way to do so
+// This information will greatly help us diagnosing and fixing the issue.
 
-<!-- Please describe the quickest way to reliably reproduce the issue, step by step. With unclear descriptions we might not able to reproduce it, thus would not be able to diagnose or fix the issue. -->
+1.
+2.
 
 ### Expected behavior
 
-<!-- Please describe what the expected behavior is in the case. Sometimes people incorrectly perceive normal behaviors as bugs, and in some other cases we do not expect the same thing as you do, so telling us what you are expecting would be helpful. -->
+### Current Behavior
 
-### Current Behavior & Other details
+### Other details
 
-<!-- Please describe what is the result after following the steps of the reproductions above, in what other cases the issue stops occurring, what you have tried to solve the issue, and what guesses you have on the cause of the issue, etc. -->