github-wiki.github.io

Unofficial Wiki about GitHub usage

Automatically Generated Table of Contents

GitHub Pages (Markdown)

GitHub Pages use a different Markdown as repository viewer!

Automatic TOC in github-flavoured-markdown

GitHub Pages (which is basically a wrapper for Jekyll) appears to use kramdown, which implements all of Maruku, and therefore has support for an automatically generated table of contents via atoc attribute:

* auto-gen TOC:
{:toc}

Inside GitHub (AsciiDoc)

Markups

GitHub Flavored Markdown (GFM)

Inline HTML

GitHub pages

Kramdown

ruby-kramdown @Debian

Lint

Jekyll

Setting up your GitHub Pages site locally with Jekyll

Configuring Jekyll _config.yml

Feeds (RSS, Atom)

Modifying an old branch and propagating changes to more recent ones

See also