Clone this repo:


  1. 66e0023 Add an --external option to md_browser to host more easily by dbeam · 12 days ago master
  2. f246a32 Default to listen just on localhost by agrieve · 6 weeks ago
  3. 65e02ae Add component and team info to some //testing, //tools OWNERS files. by dpranke · 3 months ago
  4. 4e8676f render non-markdown files as text by vapier · 3 months ago
  5. c2bbfbb set tab length to 2 by vapier · 3 months ago


This is a simple tool to render the markdown docs in a chromium checkout locally. It is written in Python and uses the Python ‘markdown’ package, which is checked into src/third_party.

md_browser attempts to emulate the flavor of Markdown implemented by Gitiles.

Gitiles is the source browser running on, and can be run locally, but to do so requires a Java install and a Buck install, which can be slightly annoying to set up on Mac or Windows.

This is a lighterweight solution, which also allows you to preview uncommitted changes (i.e., it just serves files out of the filesystem, and is not a full Git repo browser like Gitiles is).

To run md_browser:

  1. cd to the top of your chromium checkout

  2. run python tools/md_browser/

  3. There is no step three.

This will run a local web server on port 8080 that points to the top of the repo. You can specify a different port with the -p flag.