How to structure a readme file
Tutorial and cheat sheet in one file!
Headings are indicated by one or more #hashtags, while…
… it is getting smaller, and smaller…
Add a line by just adding 3 hyphens
This is a basic text, without any indenting or highlighting!
-
Indenting … One *star or -hyphen, at the beginning of a line, makes an indenting of 1st order
- when followed by another single * or - you’ve got the 2nd order
- and the 3rd order
- and so on…
- and the 3rd order
- when followed by another single * or - you’ve got the 2nd order
-
Highlighting … Surround a word with:
- italic: 1 *star
- bold: 2 *stars
- bold-italic: 3 *stars
-
Links … are simply added this way:
-
Code … is indicated with `apostrophs and can be described by a language prefix:
- 1 apostroph, no prefix –> display content in a -one line- box, without any syntax highlighting
var test = {key:'value'}; alert (test.key)
- 3 apostrophs, language prefix –> display code in a -multi line- box, with syntax highlighting
var test = {key:'value'}; alert (test.key)
What should be described in a readme.md file?!
There is also a ! … what can I do with it?
…cool we can add images by the !note of exlamation
The world is flat.
Here’s a sentence with a footnote. 1
-
This is the footnote. ↩︎