Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save paulprogrammer/8ce4070e25799b5a38e5281ca81cb932 to your computer and use it in GitHub Desktop.
Save paulprogrammer/8ce4070e25799b5a38e5281ca81cb932 to your computer and use it in GitHub Desktop.
Github Flavored Markdown cheatsheet

Github Flavored Markdown (GFMD) is based on Markdown Syntax Guide with some overwriting as described at Github Flavored Markdown

Text Writing

It is easy to write in GFMD. Just write simply like text and use the below simple "tagging" to mark the text and you are good to go!

To specify a paragraph, leave 2 spaces at the end of the line

Headings

# Sample H1
## Sample H2
### Sample H3

will produce

Sample H1

Sample H2

Sample H3


Horizontal Rules

Horizontal rule is created using --- on a line by itself.


Coding - Block

```ruby
# The Greeter class
class Greeter
  def initialize(name)
    @name = name.capitalize
  end

  def salute
    puts "Hello #{@name}!"
  end
end

# Create a new object
g = Greeter.new("world")

# Output "Hello World!"
g.salute
```

will produce

# The Greeter class
class Greeter
  def initialize(name)
    @name = name.capitalize
  end

  def salute
    puts "Hello #{@name}!"
  end
end

# Create a new object
g = Greeter.new("world")

# Output "Hello World!"
g.salute

Note: You can specify the different syntax highlighting based on the coding language eg. ruby, sh (for shell), php, etc
Note: You must leave a blank line before the \```

Coding - In-line

You can produce inline-code by using only one ` to enclose the code:

This is some code: `echo something`

will produce

This is some code: echo something


Text Formatting

Bold Text is done using **Bold Text**
Italic Text is done using *Italic Text*


Hyperlinks

  • GFMD will automatically detect URL and convert them to links like this http://www.futureworkz.com
  • To specify a link on a text, do this:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

Escape sequence

You can escape using \ eg. \`


Creating list

Adding a - will change it into a list:

- Item 1
- Item 2
- Item 3

will produce

  • Item 1
  • Item 2
  • Item 3

Quoting

You can create a quote using >:

> This is a quote

will produce

This is a quote

Table and Definition list

These two can only be created via HTML:

<table>
  <tr>
    <th>ID</th><th>Name</th><th>Rank</th>
  </tr>
  <tr>
    <td>1</td><td>Tom Preston-Werner</td><td>Awesome</td>
  </tr>
  <tr>
    <td>2</td><td>Albert Einstein</td><td>Nearly as awesome</td>
  </tr>
</table>

<dl>
  <dt>Lower cost</dt>
  <dd>The new version of this product costs significantly less than the previous one!</dd>
  <dt>Easier to use</dt>
  <dd>We've changed the product so that it's much easier to use!</dd>
</dl>

will produce

IDNameRank
1Tom Preston-WernerAwesome
2Albert EinsteinNearly as awesome
Lower cost
The new version of this product costs significantly less than the previous one!
Easier to use
We've changed the product so that it's much easier to use!

Adding Image

![Branching Concepts](http://git-scm.com/figures/18333fig0319-tn.png "Branching Map")
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment