Github Flavored Markdown (GFM) is based on Markdown Syntax Guide with some overwriting as described at Github Flavored Markdown
Below guide is based on markdownguide.org
[TOC]
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
# Sample H1
## Sample H2
### Sample H3
#### Sample H4
##### Sample H5
###### Sample H6
will produce
Horizontal rule is created using ---
on a line by itself.
```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 \
```
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
Bold Text is done using **Bold Text**
Italic Text is done using *Italic Text*
- 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.
You can escape using \ eg. \`
`hello world!`
Adding a -
will change it into a list:
- Item 1
- Item 2
- Item 3
will produce
- Item 1
- Item 2
- Item 3
You can create a quote using >
:
> This is a quote
will produce
This is a quote
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
ID | Name | Rank |
---|---|---|
1 | Tom Preston-Werner | Awesome |
2 | Albert Einstein | Nearly as awesome |
- More Features
- The new version of this project has a lot more features!
- Easier to use
- We've changed the app UI so that it's much easier to use!
![Branching Concepts](http://git-scm.com/figures/18333fig0319-tn.png "Branching Map")