diff --git a/doc/default.nix b/doc/default.nix
index a9f22267584..6a44587a31b 100644
--- a/doc/default.nix
+++ b/doc/default.nix
@@ -27,6 +27,7 @@ stdenv.mkDerivation {
     in ''
       {
         pandoc '${inputFile}' -w docbook ${optionalString useChapters "--chapters"} \
+          --smart \
           | sed -e 's|<ulink url=|<link xlink:href=|' \
               -e 's|</ulink>|</link>|' \
               -e 's|<sect. id=|<section xml:id=|' \