diff --git a/_overviews/scaladoc/for-library-authors.md b/_overviews/scaladoc/for-library-authors.md
index 7d58cc95a4..5d0d29a146 100644
--- a/_overviews/scaladoc/for-library-authors.md
+++ b/_overviews/scaladoc/for-library-authors.md
@@ -201,6 +201,8 @@ Some types of markup available:
   Indentation is relative to the starting `*` for the comment.
 - **Headings** are defined with surrounding `=` characters, with more `=` denoting
   subheadings. E.g. `=Heading=`, `==Sub-Heading==`, etc.
+- **Tables** are defined using `|` to separate elements in a row,
+  as described in the [blog](https://scala-lang.org/blog/2018/10/04/scaladoc-tables.html).
 - **List blocks** are a sequence of list items with the same style and level,
   with no interruptions from other block styles. Unordered lists can be bulleted
   using `-`; numbered lists can be denoted using `1.`, `i.`, `I.`, or `a.` for the