md_browser.py prints example URL & implicitly displays README.md files.

tools/md_browser/md_browser.py

 # Copyright 2015 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 """Simple Markdown browser for a Git checkout."""
 from __future__ import print_function
 
 import SimpleHTTPServer
 import SocketServer
 import argparse
@@ skipping 12 matching lines @@
 
 def main(argv):
   parser = argparse.ArgumentParser(prog='md_browser')
   parser.add_argument('-p', '--port', type=int, default=8080,
                       help='port to run on (default = %(default)s)')
   args = parser.parse_args(argv)
 
   try:
     s = Server(args.port, SRC_DIR)
     print("Listening on http://localhost:%s/" % args.port)
+    print(" Try loading http://localhost:%s/docs/README.md" % args.port)
     s.serve_forever()
     s.shutdown()
     return 0
   except KeyboardInterrupt:
     return 130
 
 
 def _gitiles_slugify(value, _separator):
   """Convert a string (representing a section title) to URL anchor name.
 
@@ skipping 46 matching lines @@
     full_path = os.path.abspath(os.path.join(self.server.top_level, path[1:]))
 
     if not full_path.startswith(SRC_DIR):
       self._DoUnknown()
     elif path == '/doc.css':
       self._WriteTemplate('doc.css')
     elif not os.path.exists(full_path):
       self._DoNotFound()
     elif path.lower().endswith('.md'):
       self._DoMD(path)
+    elif os.path.exists(full_path + '/README.md'):
+      self._DoMD(path + '/README.md')
     else:
       self._DoUnknown()
 
   def _DoMD(self, path):
     extensions = [
         'markdown.extensions.def_list',
         'markdown.extensions.fenced_code',
         'markdown.extensions.tables',
         'markdown.extensions.toc',
         'gitiles_ext_blocks',
@@ skipping 29 matching lines @@
     with codecs.open(path, encoding='utf-8') as fp:
       return fp.read()
 
   def _WriteTemplate(self, template):
     contents = self._Read(os.path.join('tools', 'md_browser', template))
     self.wfile.write(contents.encode('utf-8'))
 
 
 if __name__ == '__main__':
   sys.exit(main(sys.argv[1:]))