Skip to content

Instantly share code, notes, and snippets.

View yantosca's full-sized avatar

Bob Yantosca yantosca

View GitHub Profile
@yantosca
yantosca / README.rst
Created May 6, 2022 14:21 — forked from dupuy/README.rst
Common markup for Markdown and reStructuredText

Markdown and reStructuredText

GitHub supports several lightweight markup languages for documentation; the most popular ones (generally, not just at GitHub) are Markdown and reStructuredText. Markdown is sometimes considered easier to use, and is often preferred when the purpose is simply to generate HTML. On the other hand, reStructuredText is more extensible and powerful, with native support (not just embedded HTML) for tables, as well as things like automatic generation of tables of contents.