12 |
13 |
14 |
15 |
16 |
17 | > [!IMPORTANT]
18 | > Check out the official documentation on [GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) to learn more about writing and formatting syntax. Additionally, you can read the latest updates and features on Markdown by visiting the [GitHub changelog posts](https://github.blog/changelog/label/markdown/).
19 |
20 | For hands-on learning:
21 |
22 | > [!TIP]
23 | > Explore the module on [Microsoft Learn](https://learn.microsoft.com/en-us/training/modules/communicate-using-markdown/).
24 |
25 | - [Introduction](#introduction)
26 | - [Headings](#headings)
27 | - [Text styles](#text-styles)
28 | - [Normal](#normal)
29 | - [Bold](#bold)
30 | - [Italic](#italic)
31 | - [Bold and Italic](#bold-and-italic)
32 | - [Blockquotes](#blockquotes)
33 | - [Monospaced](#monospaced)
34 | - [Underlined](#underlined)
35 | - [Strike-through](#strike-through)
36 | - [Boxed](#boxed)
37 | - [Subscript](#subscript)
38 | - [Superscript](#superscript)
39 | - [Small Text](#small-text)
40 | - [Text Color](#text-color)
41 | - [Multiline](#multiline)
42 | - [Syntax Highlighting](#syntax-highlighting)
43 | - [Inline code](#inline-code)
44 | - [Code block](#code-block)
45 | - [Diff Code block](#diff-code-block)
46 | - [Alignments](#alignments)
47 | - [Tables](#tables)
48 | - [Links](#links)
49 | - [Inline](#inline)
50 | - [Reference](#reference)
51 | - [Footnote](#footnote)
52 | - [Relative](#relative)
53 | - [Auto](#auto)
54 | - [Section](#section)
55 | - [Hover](#hover)
56 | - [Enclosed](#enclosed)
57 | - [Highlight words and link it to a URL](#highlight-words-and-link-it-to-a-url)
58 | - [Images](#images)
59 | - [Theme](#theme)
60 | - [Using picture tag](#using-picture-tag)
61 | - [Using dark and light mode](#using-dark-and-light-mode)
62 | - [Group](#group)
63 | - [Badges](#badges)
64 | - [Videos](#videos)
65 | - [Lists](#lists)
66 | - [Ordered](#ordered)
67 | - [Unordered](#unordered)
68 | - [Task](#task)
69 | - [Buttons](#buttons)
70 | - [Button with emoji](#button-with-emoji)
71 | - [Collapsible items (28 July 2023)](#collapsible-items-28-july-2023)
72 | - [Horizontal Rule](#horizontal-rule)
73 | - [Diagrams (19 July 2022)](#diagrams-19-july-2022)
74 | - [Mathematical expressions (19 July 2022)](#mathematical-expressions-19-july-2022)
75 | - [Alerts (8 January 2024)](#alerts-8-january-2024)
76 | - [Mention people and teams](#mention-people-and-teams)
77 | - [Reference issues and pull requests](#reference-issues-and-pull-requests)
78 | - [Color models](#color-models)
79 | - [View Code](#view-code)
80 | - [Code in titles](#code-in-titles)
81 | - [Reference Labels](#reference-labels)
82 | - [Miscellaneous](#miscellaneous)
83 | - [Comments](#comments)
84 | - [Escaping Markdown Characters](#escaping-markdown-characters)
85 | - [Emojis](#emojis)
86 | - [Line break](#line-break)
87 | - [Back to top](#back-to-top)
88 | - [Bitbucket](#bitbucket)
89 | - [Azure DevOps Project wiki](#azure-devops-project-wiki)
90 | - [MDX](#mdx)
91 | - [Tools](#tools)
92 |
93 | # Introduction
94 |
95 | Markdown is a way of writing rich-text (formatted text) content using plain text formatting syntax. It is also a tool that converts the plain text formatting to HTML.
96 |
97 | - **2004:** [John Gruber](https://daringfireball.net/projects/markdown/) developed Markdown.
98 | - **2014:** [CommonMark](https://commonmark.org/) was established as a standard specification for Markdown to resolve inconsistencies and ambiguities in Markdown implementations. This initiative was spearheaded by [John MacFarlane](https://github.com/jgm) and backed by other Markdown enthusiasts to ensure a reliable and consistent specification.
99 |
100 | This guide will provide you with a comprehensive understanding of the key commands in [GitHub Flavored Markdown (GFM)](https://github.github.com/gfm/), it is a strict superset of CommonMark. You can read the full article, [The Ultimate Markdown Cheat Sheet](https://towardsdatascience.com/the-ultimate-markdown-cheat-sheet-3d3976b31a0) on Medium.
101 |
102 | # Headings
103 |
104 | ```md
105 | # Heading 1
106 | ## Heading 2
107 | ### Heading 3
108 | #### Heading 4
109 | ##### Heading 5
110 | ###### Heading 6
111 | ```
112 |
113 | # Heading 1
114 |
115 | ## Heading 2
116 |
117 | ### Heading 3
118 |
119 | #### Heading 4
120 |
121 | ##### Heading 5
122 |
123 | ###### Heading 6
124 |
125 | ```md
126 |
Heading 1
127 |
Heading 2
128 |
Heading 3
129 |
Heading 4
130 |
Heading 5
131 |
Heading 6
132 | ```
133 |
134 |
135 |
Heading 1
136 |
137 |
Heading 2
138 |
139 |
Heading 3
140 |
141 |
Heading 4
142 |
143 |
Heading 5
144 |
145 |
Heading 6
146 |
147 | ```md
148 | Heading 1
149 | =
150 | Heading 2
151 | -
152 | ```
153 |
154 |
155 | Heading 1
156 | =
157 |
158 | Heading 2
159 | -
160 |
161 | # Text styles
162 |
163 | ## Normal
164 |
165 | ```md
166 | The quick brown fox jumps over the lazy dog.
167 | ```
168 |
169 | The quick brown fox jumps over the lazy dog.
170 |
171 | ## Bold
172 |
173 | Mac: command+B
174 |
175 | Windows: control+B
176 |
177 | ```md
178 | **The quick brown fox jumps over the lazy dog.**
179 | __The quick brown fox jumps over the lazy dog.__
180 | The quick brown fox jumps over the lazy dog.
181 | ```
182 |
183 | **The quick brown fox jumps over the lazy dog.**
184 |
185 |
186 | __The quick brown fox jumps over the lazy dog.__
187 |
188 | The quick brown fox jumps over the lazy dog.
189 |
190 | ## Italic
191 |
192 | Mac: command+I
193 |
194 | Windows: control+I
195 |
196 | ```md
197 | *The quick brown fox jumps over the lazy dog.*
198 | _The quick brown fox jumps over the lazy dog._
199 | The quick brown fox jumps over the lazy dog.
200 | ```
201 |
202 | *The quick brown fox jumps over the lazy dog.*
203 |
204 |
205 | _The quick brown fox jumps over the lazy dog._
206 |
207 | The quick brown fox jumps over the lazy dog.
208 |
209 | ## Bold and Italic
210 |
211 | ```md
212 | **_The quick brown fox jumps over the lazy dog._**
213 | ***The quick brown fox jumps over the lazy dog.***
214 | The quick brown fox jumps over the lazy dog.
215 | ```
216 |
217 | **_The quick brown fox jumps over the lazy dog._**
218 |
219 | ***The quick brown fox jumps over the lazy dog.***
220 |
221 | The quick brown fox jumps over the lazy dog.
222 |
223 | ## Blockquotes
224 |
225 | Mac: command+shift+.
226 |
227 | Windows: control+shift+.
228 |
229 | ```md
230 | > The quick brown fox jumps over the lazy dog.
231 |
232 |
233 |
234 | > The quick brown fox jumps over the lazy dog.
235 | >
236 | > The quick brown fox jumps over the lazy dog.
237 | >
238 | > The quick brown fox jumps over the lazy dog.
239 |
240 |
241 |
242 | > The quick brown fox jumps over the lazy dog.
243 | >> The quick brown fox jumps over the lazy dog.
244 | >>> The quick brown fox jumps over the lazy dog.
245 |
246 |
247 |
248 | > **The quick brown fox** *jumps over the lazy dog.*
249 | ```
250 |
251 | > The quick brown fox jumps over the lazy dog.
252 |
253 |
254 |
255 | > The quick brown fox jumps over the lazy dog.
256 | >
257 | > The quick brown fox jumps over the lazy dog.
258 | >
259 | > The quick brown fox jumps over the lazy dog.
260 |
261 |
262 |
263 | > The quick brown fox jumps over the lazy dog.
264 | >> The quick brown fox jumps over the lazy dog.
265 | >>> The quick brown fox jumps over the lazy dog.
266 |
267 |
268 |
269 | > **The quick brown fox** *jumps over the lazy dog.*
270 |
271 | ## Monospaced
272 |
273 | ```md
274 | The quick brown fox jumps over the lazy dog.
275 | ```
276 |
277 | The quick brown fox jumps over the lazy dog.
278 |
279 | ## Underlined
280 |
281 | ```md
282 | The quick brown fox jumps over the lazy dog.
283 | ```
284 |
285 | The quick brown fox jumps over the lazy dog.
286 |
287 | ## Strike-through
288 |
289 | ```md
290 | ~~The quick brown fox jumps over the lazy dog.~~
291 | ```
292 |
293 | ~~The quick brown fox jumps over the lazy dog.~~
294 |
295 | ```md
296 |
297 | Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna
298 | aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
299 | Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint
300 | occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
301 |
302 | ```
303 |
304 |
305 | Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna
306 | aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
307 | Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint
308 | occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
309 |
717 |
718 | # Links
719 |
720 | ## Inline
721 |
722 | ```md
723 | [The-Ultimate-Markdown-Cheat-Sheet](https://github.com/lifeparticle/Markdown-Cheatsheet)
724 | ```
725 |
726 | [The-Ultimate-Markdown-Cheat-Sheet](https://github.com/lifeparticle/The-Ultimate-Markdown-Cheat-Sheet)
727 |
728 | ## Reference
729 |
730 | ```md
731 | [The-Ultimate-Markdown-Cheat-Sheet][reference text]
732 |
733 | [The-Ultimate-Markdown-Cheat-Sheet][1]
734 |
735 | [Markdown-Cheat-Sheet]
736 |
737 | [reference text]: https://github.com/lifeparticle/Markdown-Cheatsheet
738 | [1]: https://github.com/lifeparticle/Markdown-Cheatsheet
739 | [Markdown-Cheat-Sheet]: https://github.com/lifeparticle/Markdown-Cheatsheet
740 | ```
741 |
742 | [The-Ultimate-Markdown-Cheat-Sheet][reference text]
743 |
744 | [The-Ultimate-Markdown-Cheat-Sheet][1]
745 |
746 | [Markdown-Cheat-Sheet]
747 |
748 | [reference text]: https://github.com/lifeparticle/The-Ultimate-Markdown-Cheat-Sheet
749 | [1]: https://github.com/lifeparticle/The-Ultimate-Markdown-Cheat-Sheet
750 | [Markdown-Cheat-Sheet]: https://github.com/lifeparticle/The-Ultimate-Markdown-Cheat-Sheet
751 |
752 | ## Footnote
753 |
754 | Footnote.[^1]
755 |
756 | Some other important footnote.[^2]
757 |
758 | [^1]: This is footnote number one.
759 | [^2]: Here is the second footnote.
760 |
761 | ```md
762 | Footnote.[^1]
763 |
764 | Some other important footnote.[^2]
765 |
766 | [^1]: This is footnote number one.
767 | [^2]: Here is the second footnote.
768 | ```
769 |
770 |
771 |
772 | ## Relative
773 |
774 | ```md
775 | [Example of a relative link](rl.md)
776 | ```
777 |
778 | [Example of a relative link](rl.md)
779 |
780 | ## Auto
781 |
782 | ```md
783 | Visit https://github.com/
784 | ```
785 |
786 | Visit https://github.com/
787 |
788 | ```md
789 | Email at example@example.com
790 | ```
791 |
792 | Email at example@example.com
793 |
794 | ## Section
795 |
796 |
797 |
798 | ## Hover
799 |
800 | You can use [BinaryTree](https://binarytree.dev/ "Array of Developer Productivity Tools Designed to Help You Save Time") to create markdown tables.
801 |
802 |
803 | You can use [BinaryTree](## "Array of Developer Productivity Tools Designed to Help You Save Time") to create markdown tables.
804 |
805 | ## Enclosed
806 |
807 | ```md
808 |
809 | ```
810 |
811 |
812 |
813 | ## Highlight words and link it to a URL
814 |
815 | ```md
816 | [BinaryTree](https://binarytree.dev/)
817 | ```
818 |
819 | [BinaryTree](https://binarytree.dev/)
820 |
821 | 
822 |
823 | # Images
824 |
825 | Alt text and title are optional.
826 |
827 | ```md
828 | 
829 | ```
830 |
831 | 
832 |
833 | ```md
834 | ![alt text][image]
835 |
836 | [image]: https://images.unsplash.com/photo-1415604934674-561df9abf539?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=100&q=80 "Title text"
837 | ```
838 |
839 | ![alt text][image]
840 |
841 | [image]: https://images.unsplash.com/photo-1415604934674-561df9abf539?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=100&q=80 "Title text"
842 |
843 | ```md
844 |
845 | ```
846 |
847 |
848 |
849 |
850 |
851 |
852 | ```md
853 |
854 | ```
855 |
856 |
857 |
858 | ```md
859 |
860 | ```
861 |
862 |
863 |
864 | ```md
865 |
866 | ```
867 |
868 | [](https://binarytree.dev/)
869 |
870 | ```md
871 | [](https://binarytree.dev/)
872 | ```
873 |
874 |
875 |
876 |
877 | ```md
878 |
879 | ```
880 |
881 | ## Theme
882 |
883 | ### Using picture tag
884 |
885 | The HTML `` element, along with the `prefers-color-scheme` media feature, enables you to dynamically adjust images according to the user's color scheme preference, providing options for both light and dark modes.
886 |
887 | For example, the code snippet below demonstrates how to display a dark-themed BinaryTree logo when the user's device is set to a dark mode, and a light-themed BinaryTree logo for light mode settings:
888 |
889 | ```md
890 |
891 |
892 |
893 |
894 |
895 | ```
896 |
897 |
898 |
899 |
900 |
901 |
902 |
903 | ### Using dark and light mode
904 |
905 | ```md
906 | [![Badge][Logo-dark]](https://binarytree.dev#gh-dark-mode-only)
907 | [![Badge][Logo-light]](https://binarytree.dev#gh-light-mode-only)
908 |
909 | [Logo-dark]: https://github-readme-stats.vercel.app/api?username=lifeparticle&theme=graywhite&show_icons=true#gh-light-mode-only
910 | [Logo-light]: https://github-readme-stats.vercel.app/api?username=lifeparticle&theme=dark&show_icons=true#gh-dark-mode-only
911 | ```
912 |
913 | [![Badge][Logo-dark]](https://binarytree.dev#gh-dark-mode-only)
914 | [![Badge][Logo-light]](https://binarytree.dev#gh-light-mode-only)
915 |
916 | [Logo-light]: https://github-readme-stats.vercel.app/api?username=lifeparticle&theme=graywhite&show_icons=true#gh-light-mode-only
917 | [Logo-dark]: https://github-readme-stats.vercel.app/api?username=lifeparticle&theme=dark&show_icons=true#gh-dark-mode-only
918 |
919 | ```md
920 |
921 |
922 |
923 |
924 |
925 |
926 | ```
927 |
928 |
929 |
930 |
931 |
932 |
933 |
934 |
935 | ## Group
936 |
937 | Horizontal images
938 |
939 |
940 |
941 |
942 |
943 |
944 |
945 | ```md
946 |
947 |
948 |
949 |
950 |
951 | ```
952 |
953 | Horizontal images with gap
954 |
955 |
956 |
957 |
958 |
959 |
960 |
961 | ```md
962 |
963 |
964 |
965 |
966 |
967 | ```
968 |
969 | Vertical images
970 |
971 |
972 |
973 |
974 |
975 |
976 |
977 |
978 |
979 | ```md
980 |
981 |
982 |
983 |
984 |
985 |
986 |
987 | ```
988 |
989 | Vertical images with gap
990 |
991 |
992 |
993 |
994 |
995 |
996 |
997 |
998 |
999 | ```md
1000 |
1001 |
1002 |
1003 |
1004 |
1005 |
1006 |
1007 | ```
1008 |
1009 | # Badges
1010 |
1011 | ```md
1012 | 
1013 | ```
1014 |
1015 | 
1016 |
1017 | # Videos
1018 |
1019 | To embed a video in Markdown, you need to first upload the video file and then reference it inline:
1020 |
1021 | https://github.com/user-attachments/assets/90c624e0-f46b-47a7-8509-97585dc3688a
1022 |
1023 | ```md
1024 | https://github.com/user-attachments/assets/90c624e0-f46b-47a7-8509-97585dc3688a
1025 | ```
1026 |
1027 | # Lists
1028 |
1029 | ## Ordered
1030 |
1031 | Mac: command+shift+7
1032 |
1033 | Windows: control+shift+7
1034 |
1035 | ```md
1036 | 1. One
1037 | 2. Two
1038 | 3. Three
1039 | ```
1040 |
1041 | 1. One
1042 | 2. Two
1043 | 3. Three
1044 |
1045 | ```md
1046 | 1. First level
1047 | 1. Second level
1048 | - Third level
1049 | - Fourth level
1050 | 2. First level
1051 | 1. Second level
1052 | 3. First level
1053 | 1. Second level
1054 | ```
1055 |
1056 | 1. First level
1057 | 1. Second level
1058 | - Third level
1059 | - Fourth level
1060 | 2. First level
1061 | 1. Second level
1062 | 3. First level
1063 | 1. Second level
1064 |
1065 | ## Unordered
1066 |
1067 | Mac: command+shift+8
1068 |
1069 | Windows: control+shift+8
1070 |
1071 | ```md
1072 | * 1
1073 | * 2
1074 | * 3
1075 |
1076 | + 1
1077 | + 2
1078 | + 3
1079 |
1080 |
1081 | - 1
1082 | - 2
1083 | - 3
1084 | ```
1085 |
1086 |
1087 |
1088 | * 1
1089 | * 2
1090 | * 3
1091 |
1092 | + 1
1093 | + 2
1094 | + 3
1095 |
1096 |
1097 |
1098 | - 1
1099 | - 2
1100 | - 3
1101 |
1102 | ```md
1103 | - First level
1104 | - Second level
1105 | - Third level
1106 | - Fourth level
1107 | - First level
1108 | - Second level
1109 | - First level
1110 | - Second level
1111 | ```
1112 |
1113 | - First level
1114 | - Second level
1115 | - Third level
1116 | - Fourth level
1117 | - First level
1118 | - Second level
1119 | - First level
1120 | - Second level
1121 |
1122 | ```md
1123 |
1124 |
First item
1125 |
Second item
1126 |
Third item
1127 |
Fourth item
1128 |
1129 | ```
1130 |
1131 |
1132 |
First item
1133 |
Second item
1134 |
Third item
1135 |
Fourth item
1136 |
1137 |
1138 | ## Task
1139 |
1140 | ```md
1141 | - [x] Fix Bug 223
1142 | - [ ] Add Feature 33
1143 | - [ ] Add unit tests
1144 | ```
1145 |
1146 | - [x] Fix Bug 223
1147 | - [ ] Add Feature 33
1148 | - [ ] Add unit tests
1149 |
1150 | # Buttons
1151 |
1152 | ```md
1153 | cmd + shift + p
1154 | ```
1155 |
1156 | cmd + shift + p
1157 |
1158 | ```md
1159 | cmd + shift + p
1160 | ```
1161 |
1162 | cmd + shift + p
1163 |
1164 | ```md
1165 | [Markdown-Cheatsheet](https://github.com/lifeparticle/Markdown-Cheatsheet)
1166 | ```
1167 |
1168 | [Markdown-Cheatsheet](https://github.com/lifeparticle/Markdown-Cheatsheet)
1169 |
1170 | ```md
1171 | [Markdown-Cheatsheet](https://github.com/lifeparticle/Markdown-Cheatsheet)
1172 | ```
1173 |
1174 | [Markdown-Cheatsheet](https://github.com/lifeparticle/Markdown-Cheatsheet)
1175 |
1176 | ## Button with emoji
1177 |
1178 |
1179 | [Markdown-Cheatsheet](https://github.com/lifeparticle/Markdown-Cheatsheet) ↗️
1180 |
1181 | ```md
1182 | [Markdown-Cheatsheet](https://github.com/lifeparticle/Markdown-Cheatsheet) ↗️
1183 | ```
1184 |
1185 | # Collapsible items (28 July 2023)
1186 |
1187 | ```md
1188 |
1189 | Markdown
1190 |
1191 | - [Markdown Editor](https://binarytree.dev/me)
1192 | - [Table Of Content](https://binarytree.dev/toc)
1193 | - [Markdown Table Generator](https://binarytree.dev/md_table_generator)
1194 |
1195 |
1196 | ```
1197 |
1198 |
1199 | Markdown
1200 |
1201 | - [Markdown Editor](https://binarytree.dev/me)
1202 | - [Table Of Content](https://binarytree.dev/toc)
1203 | - [Markdown Table Generator](https://binarytree.dev/md_table_generator)
1204 |
1205 |
1206 |
1207 | # Horizontal Rule
1208 |
1209 | ```md
1210 | ---
1211 | ***
1212 | ___
1213 | ```
1214 |
1215 | ---
1216 |
1217 |
1218 | ***
1219 |
1220 |
1221 | ___
1222 |
1223 | # Diagrams (19 July 2022)
1224 |
1225 | ````md
1226 | ```mermaid
1227 | pie
1228 | "Movies" : 80
1229 | "TV shows" : 20
1230 | ```
1231 | ````
1232 |
1233 | ```mermaid
1234 | pie
1235 | "Movies" : 80
1236 | "TV shows" : 20
1237 | ```
1238 |
1239 | # Mathematical expressions (19 July 2022)
1240 |
1241 | > [!IMPORTANT]
1242 | > Check out the official documentation on [GitHub](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions) to learn more about writing and formatting MathJax syntax.
1243 |
1244 | ```md
1245 | This is an inline math expression $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$
1246 | ```
1247 |
1248 | This is an inline math expression $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$
1249 |
1250 | ```md
1251 | $$
1252 | x = {-b \pm \sqrt{b^2-4ac} \over 2a}
1253 | $$
1254 | ```
1255 |
1256 | $$
1257 | x = {-b \pm \sqrt{b^2-4ac} \over 2a}
1258 | $$
1259 |
1260 | # Alerts (8 January 2024)
1261 |
1262 | ```md
1263 | > [!NOTE]
1264 | > Essential details that users should not overlook, even when browsing quickly.
1265 |
1266 |
1267 |
1268 | > [!TIP]
1269 | > Additional advice to aid users in achieving better outcomes.
1270 |
1271 |
1272 |
1273 | > [!IMPORTANT]
1274 | > Vital information required for users to attain success.
1275 |
1276 |
1277 |
1278 | > [!WARNING]
1279 | > Urgent content that requires immediate user focus due to possible risks.
1280 |
1281 |
1282 |
1283 | > [!CAUTION]
1284 | > Possible negative outcomes resulting from an action.
1285 | ```
1286 |
1287 | > [!NOTE]
1288 | > Essential details that users should not overlook, even when browsing quickly.
1289 |
1290 |
1291 |
1292 | > [!TIP]
1293 | > Additional advice to aid users in achieving better outcomes.
1294 |
1295 |
1296 |
1297 | > [!IMPORTANT]
1298 | > Vital information required for users to attain success.
1299 |
1300 |
1301 |
1302 | > [!WARNING]
1303 | > Urgent content that requires immediate user focus due to possible risks.
1304 |
1305 |
1306 |
1307 | > [!CAUTION]
1308 | > Possible negative outcomes resulting from an action.
1309 |
1310 | # Mention people and teams
1311 |
1312 | In issues:
1313 |
1314 | ```md
1315 | @lifeparticle
1316 | ```
1317 |
1318 | [Example shown in issue](https://github.com/lifeparticle/Markdown-Cheatsheet/issues/1)
1319 |
1320 | In markdown file:
1321 |
1322 | ```md
1323 | https://github.com/lifeparticle
1324 | ```
1325 |
1326 | https://github.com/lifeparticle
1327 |
1328 | # Reference issues and pull requests
1329 |
1330 | In issues:
1331 |
1332 | ```md
1333 | #1
1334 | #10
1335 | ```
1336 |
1337 | [Example shown in issue](https://github.com/lifeparticle/Markdown-Cheatsheet/issues/1)
1338 |
1339 | In markdown file:
1340 |
1341 | ```md
1342 | https://github.com/lifeparticle/Markdown-Cheatsheet/issues/1
1343 | https://github.com/lifeparticle/Markdown-Cheatsheet/pull/10
1344 | ```
1345 |
1346 | https://github.com/lifeparticle/Markdown-Cheatsheet/issues/1
1347 |
1348 | https://github.com/lifeparticle/Markdown-Cheatsheet/pull/10
1349 |
1350 | # Color models
1351 |
1352 | In issues:
1353 |
1354 | ```md
1355 | `#ffffff`
1356 | `#000000`
1357 | ```
1358 |
1359 | [Example shown in issue](https://github.com/lifeparticle/Markdown-Cheatsheet/issues/1)
1360 |
1361 | 
1362 |
1363 | # View Code
1364 |
1365 | Click either the Code (top right) or Raw (top left) option to see the markdown code.
1366 |
1367 |
1368 |
1369 | > [!NOTE]
1370 | > Make sure you have clicked the markdown file to see the above view.
1371 |
1372 |
1373 |
1374 | # Code in titles
1375 |
1376 | In issue, and pull request titles.
1377 |
1378 | `TEST` ISSUE
1379 |
1380 | ```md
1381 |
1382 | `TEST` ISSUE
1383 |
1384 | ```
1385 |
1386 |
1387 |
1388 | # Reference Labels
1389 |
1390 | Labels referenced by URLs in Markdown are now automatically rendered.
1391 |
1392 | https://github.com/lifeparticle/Markdown-Cheatsheet/labels/documentation
1393 |
1394 | ```md
1395 | https://github.com/lifeparticle/Markdown-Cheatsheet/labels/documentation
1396 | ```
1397 |
1398 | # Miscellaneous
1399 |
1400 | ## Comments
1401 |
1402 |
1405 |
1406 | ```md
1407 |
1410 | ```
1411 |
1412 | ## Escaping Markdown Characters
1413 |
1414 | - **Before escaping**
1415 |
1416 | ```md
1417 | * Asterisk
1418 | \ Backslash
1419 | ` Backtick
1420 | {} Curly braces
1421 | . Dot
1422 | ! Exclamation mark
1423 | # Hash symbol
1424 |
1425 | - Hyphen symbol
1426 |
1427 | () Parentheses
1428 |
1429 | + Plus symbol
1430 |
1431 | [] Square brackets
1432 | _ Underscore`
1433 | ```
1434 |
1435 | * Asterisk
1436 | \ Backslash
1437 | ` Backtick
1438 | {} Curly braces
1439 | . Dot
1440 | ! Exclamation mark
1441 |
1442 | # Hash symbol
1443 |
1444 | - Hyphen symbol
1445 |
1446 | () Parentheses
1447 |
1448 | + Plus symbol
1449 |
1450 | [] Square brackets
1451 | _ Underscore
1452 |
1453 | - **After escaping**
1454 |
1455 | ```md
1456 | \* Asterisk
1457 | \\ Backslash
1458 | \` Backtick
1459 | \{} Curly braces
1460 | \. Dot
1461 | \! Exclamation mark
1462 | \# Hash symbol
1463 | \- Hyphen symbol
1464 | \() Parentheses
1465 | \+ Plus symbol
1466 | \[] Square brackets
1467 | \_ Underscore
1468 | ```
1469 |
1470 | \* Asterisk
1471 | \\ Backslash
1472 | \` Backtick
1473 | \{} Curly braces
1474 | \. Dot
1475 | \! Exclamation mark
1476 | \# Hash symbol
1477 | \- Hyphen symbol
1478 | \() Parentheses
1479 | \+ Plus symbol
1480 | \[] Square brackets
1481 | \_ Underscore
1482 |
1483 | ## Emojis
1484 |
1485 | ```md
1486 | :octocat:
1487 | ```
1488 |
1489 | :octocat:
1490 |
1491 | [Complete list of github markdown emoji markup](https://gist.github.com/rxaviers/7360908)
1492 |
1493 | ## Line break
1494 |
1495 |
1496 | You can use ` ` to insert a single line break. Make sure to use an em space ` `. For example:
1497 |
1498 | ```md
1499 |
The quick brown fox jumps over the lazy dog.
1500 | ```
1501 |
1502 |
The
1503 | quick brown fox jumps over the lazy
1504 | dog.
1505 |
1506 | Or
1507 |
1508 | ```md
1509 |
The quick brown fox jumps over the lazy dog.
1510 | ```
1511 |
1512 |
The
1513 | quick brown fox jumps over the lazy
1514 | dog.
1515 |
1516 | ## Back to top
1517 |
1518 | First place the following code at start of your markdown file
1519 |
1520 | ```md
1521 |
1522 | ```
1523 |
1524 | Then use one of the following code at the place you want to return to top.
1525 |
1526 | [Back to top](#top)
1527 |
1528 | [:arrow_up:](#top)
1529 |
1530 | ```md
1531 | [Back to top](#top)
1532 |
1533 | [:arrow_up:](#top)
1534 | ```
1535 |
1536 | # Bitbucket
1537 |
1538 | Bitbucket Supported Markdown for [READMEs](https://confluence.atlassian.com/bitbucketserver/markdown-syntax-guide-776639995.html). Also, create a [table of contents](https://support.atlassian.com/bitbucket-cloud/docs/add-a-table-of-contents-to-a-wiki/).
1539 |
1540 | # Azure DevOps Project wiki
1541 |
1542 | Azure DevOps Supported Markdown for [Project wiki](https://learn.microsoft.com/en-us/azure/devops/project/wiki/markdown-guidance?view=azure-devops).
1543 |
1544 | # MDX
1545 |
1546 | You can write JSX in your markdown document using [MDX](https://mdxjs.com/).
1547 |
1548 | # Tools
1549 |
1550 | 1. Create a Markdown table of content - [binarytree](https://binarytree.dev/markdown/toc), [github-markdown-toc](https://github.com/ekalinin/github-markdown-toc)
1551 | 2. Create an empty Markdown table - [Tablesgenerator](https://www.tablesgenerator.com/markdown_tables)
1552 | 3. Convert Excel to Markdown table - [Tableconvert](https://tableconvert.com/)
1553 | 4. Markdown preview for Sublime Text 3 - [Packagecontrol](https://packagecontrol.io/packages/MarkdownPreview)
1554 | 5. Markdown preview Visual Studio Code - [Markdown Preview Enhanced](https://marketplace.visualstudio.com/items?itemName=shd101wyy.markdown-preview-enhanced)
1555 | 6. A collection of awesome markdown goodies - [Awesome Markdown](https://github.com/mundimark/awesome-markdown)
1556 | 7. Markdownlint - [markdownlint](https://github.com/DavidAnson/markdownlint), [markdownlint-cli2](https://github.com/DavidAnson/markdownlint-cli2), [markdownlint-cli2-action](https://github.com/DavidAnson/markdownlint-cli2-action), [vscode-markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint)
1557 | 8. A lightweight Python utility for converting various files to Markdown - [Markitdown](https://github.com/microsoft/markitdown)
1558 | 9. A SSE MCP server for calling MarkItDown - [MarkItDown-MCP](https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp)
1559 |
1560 | ---
1561 |
1562 |
1563 |
1564 | This README has been optimized for accessibility based on GitHub's blogpost
1565 | "[Tips for Making your GitHub Profile Page Accessible](https://github.blog/2023-10-26-5-tips-for-making-your-github-profile-page-accessible)".
1566 |
1567 |