Important
Check out the official documentation on GitHub to learn more about writing and formatting syntax.
Markdown is a method for writing formatted text using a simple plain text format. This guide will provide you with a comprehensive understanding of the key commands in Markdown, aimed at enhancing your GitHub README.
You can read the full article on Medium, but here's a brief overview of the most popular commands.
- Headings
- Text styles
- Syntax Highlighting
- Alignments
- Tables
- Links
- Images
- Badges
- Lists
- Buttons
- Collapsible items (28 July 2023)
- Horizontal Rule
- Diagrams (19 July 2022)
- Mathematical expressions (19 July 2022)
- Alerts (8 January 2024)
- Mention people and teams
- Reference issues and pull requests
- Color models
- Miscellaneous
- Hash symbol
- Bitbucket
- Azure DevOps Project wiki
- Tools
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
<h1>Heading 1</h1>
<h2>Heading 2</h2>
<h3>Heading 3</h3>
<h4>Heading 4</h4>
<h5>Heading 5</h5>
Bold
**The quick brown fox jumps over the lazy dog.**
__The quick brown fox jumps over the lazy dog.__
<strong>The quick brown fox jumps over the lazy dog.</strong>
Italic
*The quick brown fox jumps over the lazy dog.*
_The quick brown fox jumps over the lazy dog._
<em>The quick brown fox jumps over the lazy dog.</em>
Bold and Italic
**_The quick brown fox jumps over the lazy dog._**
<strong><em>The quick brown fox jumps over the lazy dog.</em></strong>
The quick brown fox jumps over the lazy dog.
Bold
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
Italic
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
Bold and Italic
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
Blockquotes
> The quick brown fox jumps over the lazy dog.
> The quick brown fox jumps over the lazy dog.
>
> The quick brown fox jumps over the lazy dog.
>
> The quick brown fox jumps over the lazy dog.
> The quick brown fox jumps over the lazy dog.
>> The quick brown fox jumps over the lazy dog.
>>> The quick brown fox jumps over the lazy dog.
> **The quick brown fox** *jumps over the lazy dog.*
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
Monospaced
<samp>The quick brown fox jumps over the lazy dog.</samp>
Underlined
<ins>The quick brown fox jumps over the lazy dog.</ins>
Strike-through
~~The quick brown fox jumps over the lazy dog.~~
Monospaced
The quick brown fox jumps over the lazy dog.
Underlined
The quick brown fox jumps over the lazy dog.
Strike-through
The quick brown fox jumps over the lazy dog.
Boxed
<table><tr><td>The quick brown fox jumps over the lazy dog.</td></tr></table>
Boxed
The quick brown fox jumps over the lazy dog. |
2 <sup>53-1</sup> and -2 <sup>53-1</sup>
2 53-1 and -2 53-1
Subscript <sub>The quick brown fox jumps over the lazy dog.</sub>
Superscript <sup>The quick brown fox jumps over the lazy dog.</sup>
Subscript The quick brown fox jumps over the lazy dog.
Superscript The quick brown fox jumps over the lazy dog.
A class method is an instance method of the class object. When a new class is created, an object of type Class
is initialized and assigned to a global constant (Mobile in this case).
public static String monthNames[] = {"January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"};
public static String monthNames[] = {"January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"};
Refer to this and this GitHub document to find all the valid keywords.
- this code or text is the old version
+ this is what it was changed to
```diff
- this code or text is the old version
+ this is what it was changed to
```
<p align="left">
<img src="https://images.unsplash.com/photo-1415604934674-561df9abf539?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=2772&q=80" width="100" height="100" border="10"/>
</p>
<p align="center">
<img src="https://images.unsplash.com/photo-1415604934674-561df9abf539?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=2772&q=80" width="100" height="100" border="10"/>
</p>
<p align="right">
<img src="https://images.unsplash.com/photo-1415604934674-561df9abf539?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=2772&q=80" width="100" height="100" border="10"/>
</p>
<h3 align="center"> My latest Medium posts </h3>
<table>
<tr>
<td width="33%"">
The quick brown fox jumps over the lazy dog.
</td>
<td width="33%">
The quick brown fox jumps over the lazy dog.
</td>
<td width="33%">
The quick brown fox jumps over the lazy dog.
</td>
</tr>
</table>
The quick brown fox jumps over the lazy dog. | The quick brown fox jumps over the lazy dog. | The quick brown fox jumps over the lazy dog. |
| Default | Left align | Center align | Right align |
| - | :- | :-: | -: |
| 9999999999 | 9999999999 | 9999999999 | 9999999999 |
| 999999999 | 999999999 | 999999999 | 999999999 |
| 99999999 | 99999999 | 99999999 | 99999999 |
| 9999999 | 9999999 | 9999999 | 9999999 |
| Default | Left align | Center align | Right align |
| ---------- | :--------- | :----------: | ----------: |
| 9999999999 | 9999999999 | 9999999999 | 9999999999 |
| 999999999 | 999999999 | 999999999 | 999999999 |
| 99999999 | 99999999 | 99999999 | 99999999 |
| 9999999 | 9999999 | 9999999 | 9999999 |
Default | Left align | Center align | Right align
---------- | :--------- | :----------: | ----------:
9999999999 | 9999999999 | 9999999999 | 9999999999
999999999 | 999999999 | 999999999 | 999999999
99999999 | 99999999 | 99999999 | 99999999
9999999 | 9999999 | 9999999 | 9999999
Default | Left align | Center align | Right align |
---|---|---|---|
9999999999 | 9999999999 | 9999999999 | 9999999999 |
999999999 | 999999999 | 999999999 | 999999999 |
99999999 | 99999999 | 99999999 | 99999999 |
9999999 | 9999999 | 9999999 | 9999999 |
Default | Left align | Center align | Right align |
---|---|---|---|
9999999999 | 9999999999 | 9999999999 | 9999999999 |
999999999 | 999999999 | 999999999 | 999999999 |
99999999 | 99999999 | 99999999 | 99999999 |
9999999 | 9999999 | 9999999 | 9999999 |
Default | Left align | Center align | Right align |
---|---|---|---|
9999999999 | 9999999999 | 9999999999 | 9999999999 |
999999999 | 999999999 | 999999999 | 999999999 |
99999999 | 99999999 | 99999999 | 99999999 |
9999999 | 9999999 | 9999999 | 9999999 |
<table>
<tr>
<th>Heading 1</th>
<th>Heading 2</th>
</tr>
<tr>
<td>
| A | B | C |
|--|--|--|
| 1 | 2 | 3 |
</td><td>
| A | B | C |
|--|--|--|
| 1 | 2 | 3 |
</td></tr> </table>
Heading 1 | Heading 2 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
| A | B | C |
|---|---|---|
| 1 | 2 | 3 <br/> 4 <br/> 5 |
A | B | C |
---|---|---|
1 | 2 | 3 4 5 |
<table>
<tr>
<th>Before Hoisting</th>
<th>After Hoisting</th>
</tr>
<tr>
<td>
<pre lang="js">
console.log(fullName); // undefined
fullName = "Dariana Trahan";
console.log(fullName); // Dariana Trahan
var fullName;
</pre>
</td>
<td>
<pre lang="js">
var fullName;
console.log(fullName); // undefined
fullName = "Dariana Trahan";
console.log(fullName); // Dariana Trahan
</pre>
</td>
</tr>
</table>
Before Hoisting | After Hoisting |
---|---|
console.log(fullName); // undefined
fullName = "Dariana Trahan";
console.log(fullName); // Dariana Trahan
var fullName; |
var fullName;
console.log(fullName); // undefined
fullName = "Dariana Trahan";
console.log(fullName); // Dariana Trahan |
[The-Ultimate-Markdown-Cheat-Sheet](https://github.com/lifeparticle/Markdown-Cheatsheet)
The-Ultimate-Markdown-Cheat-Sheet
[The-Ultimate-Markdown-Cheat-Sheet][reference text]
[The-Ultimate-Markdown-Cheat-Sheet][1]
[Markdown-Cheat-Sheet]
[reference text]: https://github.com/lifeparticle/Markdown-Cheatsheet
[1]: https://github.com/lifeparticle/Markdown-Cheatsheet
[Markdown-Cheat-Sheet]: https://github.com/lifeparticle/Markdown-Cheatsheet
The-Ultimate-Markdown-Cheat-Sheet
The-Ultimate-Markdown-Cheat-Sheet
Footnote.1
Some other important footnote.2
Footnote.[^1]
Some other important footnote.[^2]
[^1]: This is footnote number one.
[^2]: Here is the second footnote.
[Example of a relative link](rl.md)
Visit https://github.com/
Visit https://github.com/
![alt text](https://images.unsplash.com/photo-1415604934674-561df9abf539?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=100&q=80)
![alt text][image]
[image]: https://images.unsplash.com/photo-1415604934674-561df9abf539?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=100&q=80
<img src="https://images.unsplash.com/photo-1415604934674-561df9abf539?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=2772&q=80" width="100" height="100" border="10"/>
![GitHub forks](https://img.shields.io/github/forks/lifeparticle/Markdown-Cheatsheet?style=for-the-badge)
1. One
2. Two
3. Three
- One
- Two
- Three
1. First level
1. Second level
- Third level
- Fourth level
2. First level
1. Second level
3. First level
1. Second level
- First level
- Second level
- Third level
- Fourth level
- Third level
- Second level
- First level
- Second level
- First level
- Second level
* 1
* 2
* 3
+ 1
+ 2
+ 3
- 1
- 2
- 3
- 1
- 2
- 3
- 1
- 2
- 3
- 1
- 2
- 3
- First level
- Second level
- Third level
- Fourth level
- First level
- Second level
- First level
- Second level
- First level
- Second level
- Third level
- Fourth level
- Third level
- Second level
- First level
- Second level
- First level
- Second level
<ul>
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ul>
- First item
- Second item
- Third item
- Fourth item
- [x] Fix Bug 223
- [ ] Add Feature 33
- [ ] Add unit tests
- Fix Bug 223
- Add Feature 33
- Add unit tests
<kbd>cmd + shift + p</kbd>
cmd + shift + p
<kbd> <br> cmd + shift + p <br> </kbd>
cmd + shift + p
<kbd>[Markdown-Cheatsheet](https://github.com/lifeparticle/Markdown-Cheatsheet)</kbd>
[<kbd>Markdown-Cheatsheet</kbd>](https://github.com/lifeparticle/Markdown-Cheatsheet)
<details>
<summary>Markdown</summary>
- <kbd>[Markdown Editor](https://binarytree.dev/me)</kbd>
- <kbd>[Table Of Content](https://binarytree.dev/toc)</kbd>
- <kbd>[Markdown Table Generator](https://binarytree.dev/md_table_generator)</kbd>
</details>
---
***
___
pie
"Movies" : 80
"TV shows" : 20
pie
"Movies" : 80
"TV shows" : 20
This is an inline math expression $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$
This is an inline math expression
x = {-b \pm \sqrt{b^2-4ac} \over 2a}
> [!NOTE]
> Essential details that users should not overlook, even when browsing quickly.
> [!TIP]
> Additional advice to aid users in achieving better outcomes.
> [!IMPORTANT]
> Vital information required for users to attain success.
> [!WARNING]
> Urgent content that requires immediate user focus due to possible risks.
> [!CAUTION]
> Possible negative outcomes resulting from an action.
Note
Essential details that users should not overlook, even when browsing quickly.
Tip
Additional advice to aid users in achieving better outcomes.
Important
Vital information required for users to attain success.
Warning
Urgent content that requires immediate user focus due to possible risks.
Caution
Possible negative outcomes resulting from an action.
@lifeparticle
@lifeparticle
#
#
`#ffffff`
`#000000`
<!--
Lorem ipsum dolor sit amet
-->
Before escaping
* Asterisk
\ Backslash
` Backtick
{} Curly braces
. Dot
! Exclamation mark
# Hash symbol
- Hyphen symbol
() Parentheses
+ Plus symbol
[] Square brackets
_ Underscore`
- Asterisk \ Backslash ` Backtick {} Curly braces . Dot ! Exclamation mark
- Hyphen symbol () Parentheses
- Plus symbol [] Square brackets _ Underscore
After escaping
\* Asterisk
\\ Backslash
\` Backtick
\{} Curly braces
\. Dot
\! Exclamation mark
\# Hash symbol
\- Hyphen symbol
\() Parentheses
\+ Plus symbol
\[] Square brackets
\_ Underscore
* Asterisk \ Backslash ` Backtick {} Curly braces . Dot ! Exclamation mark # Hash symbol - Hyphen symbol () Parentheses + Plus symbol [] Square brackets _ Underscore
:octocat:
Complete list of github markdown emoji markup
You can use <br>
to insert a single line break. Make sure to use an em space
. For example:
<table><tr><td> <br> The quick brown fox jumps over the lazy dog. <br> </td></tr></table>
The quick brown fox jumps over the lazy dog. |
Or
<table><tr><td> <br><br><br> The quick brown fox jumps over the lazy dog. <br><br><br> </td></tr></table>
The quick brown fox jumps over the lazy dog. |
First place the following code at start of your markdown file
<a name="top"></a>
Then use one of the following code at the place you want to return to top.
[Back to top](#top)
[:arrow_up:](#top)
Bitbucket Supported Markdown for READMEs. Also, create a table of contents.
Azure DevOps Supported Markdown for Project wiki.
- Create a Markdown table of content - binarytree, github-markdown-toc
- Create an empty Markdown table - Tablesgenerator
- Convert Excel to Markdown table - Tableconvert
- Markdown preview for Sublime Text 3 - Packagecontrol
- Markdown preview Visual Studio Code - Markdown Preview Enhanced
- A collection of awesome markdown goodies - Awesome Markdown