diff --git a/README.md b/README.md
index ff35d8a..d15d059 100644
--- a/README.md
+++ b/README.md
@@ -72,6 +72,8 @@ python -m pybadges \
 
 ![pip installation](tests/golden-images/complete.svg)
 
+#### A note about `--logo` and `--embed-logo`
+
 Note that the `--logo` option can include a regular URL:
 
 ```sh
@@ -96,6 +98,13 @@ You can see the difference in your browser:
 
 ![--embed-logo=yes](tests/golden-images/embedded-logo.svg) ![--embed-logo=no](tests/golden-images/no-embedded-logo.svg)
 
+#### A note about `--(whole|left|right)-title`
+
+The `title` element is usually displayed as a
+[pop-up by browsers](https://developer.mozilla.org/en-US/docs/Web/SVG/Element/title)
+but is currently
+[filtered by Github](https://github.com/github/markup/issues/1267).
+
 
 ### Library usage