diff --git a/src/applications/diffusion/conduit/ConduitAPI_diffusion_readmequery_Method.php b/src/applications/diffusion/conduit/ConduitAPI_diffusion_readmequery_Method.php
--- a/src/applications/diffusion/conduit/ConduitAPI_diffusion_readmequery_Method.php
+++ b/src/applications/diffusion/conduit/ConduitAPI_diffusion_readmequery_Method.php
@@ -8,8 +8,8 @@
 
   public function getMethodDescription() {
     return
-      'Retrieve any "readme" that can be found for a set of paths in '.
-      'repository.';
+      pht('Retrieve any "readme" that can be found for a set of paths in '.
+          'repository.');
   }
 
   public function defineReturnType() {
@@ -89,6 +89,17 @@
       $engine = PhabricatorMarkupEngine::newDiffusionMarkupEngine();
       $engine->setConfig('viewer', $request->getUser());
       $readme_content = $engine->markupText($readme_content);
+      $toc = PhutilRemarkupEngineRemarkupHeaderBlockRule::renderTableOfContents(
+        $engine);
+      if ($toc) {
+        $toc = phutil_tag_div('phabricator-remarkup-toc', array(
+          phutil_tag_div(
+            'phabricator-remarkup-toc-header',
+            pht('Table of Contents')),
+          $toc,
+        ));
+        $readme_content = array($toc, $readme_content);
+      }
 
       $class = 'phabricator-remarkup';
     }
diff --git a/src/infrastructure/markup/PhabricatorMarkupEngine.php b/src/infrastructure/markup/PhabricatorMarkupEngine.php
--- a/src/infrastructure/markup/PhabricatorMarkupEngine.php
+++ b/src/infrastructure/markup/PhabricatorMarkupEngine.php
@@ -352,6 +352,7 @@
    */
   public static function newDiffusionMarkupEngine(array $options = array()) {
     return self::newMarkupEngine(array(
+      'header.generate-toc' => true,
     ));
   }