diff --git a/doc/ikiwiki/directive/table.mdwn b/doc/ikiwiki/directive/table.mdwn

index 2dac977244ed9329beaaf015b146d6c2d409d6d8..3e791778978e42b87d20d55eeee813555c338408 100644 (file)
--- a/doc/ikiwiki/directive/table.mdwn
+++ b/doc/ikiwiki/directive/table.mdwn
@@ -26,7 +26,7 @@ cells. For example:
         \[[!table data="""
         left||right|
         a|b|c|d
-       this cell spans 4 columns|||
+       this cell spans **4** columns|||
         """]]
  
  ## usage
@@ -42,4 +42,12 @@ cells. For example:
    as the table header. Set it to "no" to make a table without a header, or
    "column" to make the first column be the header.
  
+For tab-delimited tables (often obtained by copying and pasting from HTML
+or a spreadsheet), `delimiter` must be set to a literal tab character. These
+are difficult to type in most web browsers - copying and pasting one from
+the table data is likely to be the easiest way.
+
+Note that the contents of table cells can contain arbitrary ikiwiki and
+markdown markup.
+
  [[!meta robots="noindex, follow"]]