小组学长建议我可以把博客上传到Github上,于是打开了Markdown的大门。不难,研究了一下就能上手了,并且页面清晰又整洁,好喜欢好喜欢。
看教程➕github上操作了一波,上传了第一篇用Markdown写的文档:
https://github.com/yanyanran/YBlog/blob/main/Markdown%E8%AF%AD%E6%B3%95.md
效果:
源码:
源于想把自己的博客上传到github上的有感而学
导语
Markdown 是一种轻量级的 「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑,Markdown 的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的 HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。
Markdown编辑后保存以 .md为结尾的文件即可。
1. 标题
标题是每篇文章都需要也是最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加 # 号即可(记得#号后面加空格哦)。
“#” 一级标题
“##” 二级标题
“###” 三级标题
2. 列表
列表包括有序列表和无序列表。在 Markdown 下,列表的显示只需要在文字前加上 - 或 * 即可变为无序列表;而有序列表则直接在文字前加1. 2. 3. (符号和文字之间要加一个空格)。
- 无序列表
- 长这样
3. 引用(加框框)
有时你想让一段话或代码看起来更显眼,就可以用引用格式,like this:
这是一个引用
那么只需要在文本前加 > 号即可。
4. 粗体与斜体
用 两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法(*前面要加个空格喔)。
粗体
斜体
5. 换行
普通换行:文本结束后加 两个空格
段落换行:使用反斜杠 \
6. 引用代码
引用代码有两种形式。一种是在文本中引入一个代码:使用一个倒引号`括起来;另一种是插入一段代码,使用三个倒引号```括起来:
代码引用长这样
int b = 2; int c = a+b;
7. 表格
以下为 Markdown 中的表格格式:
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
表格长这样
Tables Are Cool col 3 is right-aligned $1600 col 2 is centered $12 zebra stripes are neat $1
8. 还可以加一些可可爱爱的Emoji
Emoji库:🎁 Emoji cheat sheet for GitHub, Basecamp, Slack & more
9. 插入图片
插入本地/网络图片
![avatar](本地路径/网络链接)
缺点:不灵活、不好分享,路径的更改或丢失都会导致Markdown调不出图 插入图片的其他方法我日后再探。