diff --git a/git-log.md b/git-log.md
new file mode 100644
index 000000000..0b17d4954
--- /dev/null
+++ b/git-log.md
@@ -0,0 +1,82 @@
+---
+title: git log
+---
+
+### Revision ranges
+See [gitrevisions](git-revisions.html).
+
+```
+git log master             # branch
+git log origin/master      # branch, remote
+git log v1.0.0             # tag
+
+git log master develop
+
+git log v2.0..master       # reachable from *master* but not *v2.0*
+git log v2.0...master      # reachable from *master* and *v2.0*, but not both
+```
+
+### Basic filters
+
+```
+git log
+  -n, --max-count=2
+      --skip=2
+
+      --since="1 week ago"
+      --until="yesterday"
+
+      --author="Rico"
+      --committer="Rico"
+```
+
+### Search
+
+```
+git log
+      --grep="Merge pull request"   # in commit messages
+      -S"console.log"               # in code
+      -G"foo.*"                     # in code (regex)
+
+      --invert-grep
+      --all-match                   # AND in multi --grep
+```
+
+### Limiting
+
+```
+git log
+      --merges
+      --no-merges
+
+      --first-parent          # no stuff from merged branches
+
+      --branches="feature/*"
+      --tags="v*"
+      --remotes="origin"
+```
+
+### Simplification
+
+```
+git log -- app/file.rb            # only file
+      --simplify-by-decoration    # tags and branches
+```
+
+### Ordering
+
+```
+      --date-order
+      --author-date-order
+      --topo-order              # "smart" ordering
+      --reverse
+```
+
+### Formatting
+
+```
+      --pretty="..."       # see man git-log / PRETTY FORMATS
+      --abbrev-commit
+      --oneline
+      --graph
+```