第二章 学习使用基础语法和GFM扩展语法
[我是开头,引用后面定义的链接][mgj]
md
(下面讲到锚点,点击会跳转到这里)
个人总结:无
摘要:
  第二章主要介绍了Markdown基本语法和最为流行的Github flavored Markdown GFW扩展语法;
那我可就直接写几个语法和示例了
1.底线写法:标题。在Markdown语法中,标题支持两种写法一种是底线,使用-或者=,另一种是使用#。
使用底线的话,只支持一级标题和两级标题,而且-或者=符号至少2个,=标识一级标题,-标识二级标题。
我是一级大标题
我是底线-二级标题
使用#标识,(推荐)
语法格式:# + 空格 + 标题内容
#个数表示标题级数,代表H1-H6,举例:
一级标题
二级标题
六级标题
一般来说,标题前后都要空一行,这样易于阅读。在源码格式下,回车3行。标题前后要赶紧利索,前后不要有空格,也不要有各种标点符号比如分号冒号等。标题尽可能简单,尤其是当生成目录时。
2.粗体和斜体。
Markdown语法中用两个*表示粗体,或者用两个_表示粗体,用一个*或者一个_表示斜体。建议使用星号标识,因为常见且易于阅读。
我是粗体
我是粗体
我是斜体
我是斜体
TIPS:建议粗体、斜体,*中间不要有空格。
- 列表。
列表分为有序列表和无序列表。有序列表使用数字 + 英文逗号 + 空格 + 内容。
无序列表用-或者+或者* + 空格 + 内容,这里建议使用-。
- 无序1
- 回车了一下然后TAB一下,有序1
- 有序2
- 无序2
- 无序3
- 分隔线。
分割线由3个以上*或者-或者_来表示。个人建议用-来表示,写起来简单。在使用分割线时候,当前行不能有其他字符(可以有空格,但是谁又会那样做呢)
- 图片(哎,比较有意思,而且重要)
好的文章总是图文并茂的,用一句稍稍不雅的话来说:‘无图言DIAO’,图片语法格式如下:
![图片代替问题,类似于H5中的图片alt属性,当图片不能显示时文字显示](图片地址 + 空格 + ‘可选的介绍title,怎么理解,就是鼠标悬浮到图片上会看到效果’)
图片地址支持网络地址、本地地址(可以相对也可以绝对路径)。
Tips:
好记性不如烂笔头,站在岸上学不会游泳,这个是小学学的吧。遇到Markdown图片插入问题,你总不能每次都使用本地图片吧,每次发布或者移动位置都要改动??这时候你需要图床来帮你。图床哦
- 链接
链接也是很常用的,链接分为以下几种:
6.1. 文字链接
语法格式:链接文字
我是一只破该仔,破呀破该仔
6.2. 引用链接
怎么理解,不好说,感觉第一印象就是H5中的锚点。来实际操作看下效果吧。
[mgj]:https://www.pusdn.com
然而,实际用起来,不是锚点,感觉实际场景更像,你好多地方都要跳转一个同一链接,可以事先定义好变量,然后其他地方引用。一处已定义变量,多出引用变量。
6.3. 网址链接
使用一对小于号来表示,<可以输入网址URL或者邮箱>
https://pusdn.com
7.行内代码与代码块
哦吼,这个对于某些IT相关的书写项目文档,示例文档,接口文档等,还是有点东西的。
7.1. 行内代码
是不是也可以理解为单行代码哦,怎么用?``来表示,不是单引号哦,比如笔记本是1-0数字按键左边那个。英文状态下击打。
这个是示例哦,例如:Linux中重启命令为:reboot now
,关机命令为:power off
是不是感觉有点像钢铁侠一个片段。power down!
7.2 代码块
Markdown语法使用tab键开头或者4个空格。
def test_main();
pass
然而,有的工具还是不太明显,比如深色凸显代码块。GFW做得较为美观。太多代码推荐:
1 | def print(); |
1 | System.out.println("要是在写代码块的时候顺便根据编程语言类型,相应地代码提示就好了,貌似sublime text + 插件方法可以。但是又有什么必须呢,你也不会用sublime再根据Markdown来编写代码吧,肯定是从IDE复制编写好**啦**); |
8.引用
使用小于号来引用内容,可以理解为引用自己的话。多行引用每行开头都可以加上>,在引用中可以嵌套引用,而且其他语法也可以使用,比如粗体等。
建议在每行引用小于号后加一个空格(这个是文中建议的)
其实我试了试,直接小于号+内容,显示出来效果和小于号 + 一个空额 + 内容,显示效果是一样的,偷懒,我感觉完全没必要,除非是源码格式下,易于阅读。
后来我的意见改了,还是在**小于号加一个空格,太漂亮,易于阅读,而且使用工具比如Typora后回车直接还是按你的格式来(有空格)
另外一个就是,不建议在引用中添加空行
你说气不气人!
我是嵌套引用:语法建议:> + 一个空格 + > + 一个空格 + > + 一个空格
9.转义
顾名思义,老掉牙的东西了,对于特殊符号,不想要被Markdown渲染,要显示在页面上可以用\来操作。
举例:
斜体Markdown语法:* 斜体
下面介绍GFM语法
删除线
被删除的文字两端没有空格 哦表情符号
更多表情符号查看:https://www.webfx.com/tools/emoji-cheat-sheet/
:表情符号代码:
:cn:自动链接
网络连接,在标准语法中链接需要用、< >来括起来,但是在GFM扩展语法中,会自动识别哦,真是精进了不少。不过貌似只能识别HTTP/HTTPS/WWW开头的。如果不想被识别,可以用``还是tab键位上面那个。
www.pusdn.comhttps://www.pusdn.com
表格
建议不要使用太多庞大复杂的表格,那样不易于维护和阅读,而且表格中不支持块级元素(代码块、引用块)。
表格格式:默认左对齐表头1 表头2 表头3 1行1列 1行2列 1行3列 2行1列 2行2列 2行3列 左对齐:(均为英文冒号) 右对齐-: 居中对齐:-:(好奇怪,看冒号的样子,为什么不叫两端对齐) 任务列表
语法格式:
- 空格 + [空格或者X]
x可以大写,也可以小写,但是有的编辑器可能不支持大写,所以推荐小写。x代表选中,空格代表不选中。
- 空格 + [空格或者X]
- 篮球
- 大篮球
- 小篮球
- 中篮球
- 足球
- 排球
锚点
终于看到这个了,有点实际作用。尤其是点击目录跳转。
语法格式:
锚点描述好的排版套路
好的排版看起来真是漂亮。下面简单摘抄几句书中的几句话。
7.1. 一些加空格的情况
- 英文标点符号与后面的字符需要加空格,与前面的空格不需要空格。这点类似于Java代码方法参数定义。
7.2. 不加空格的情况
-中文标点一般和后面都不需要加空格,因为英文标点符号看起来已经有间距了。
- 全角和半角
全角:中文标点符。
有工具帮你检查那是有多爽?VS Code和Typora都可以。
本文使用Windows,typora源码模式编写于2020-03-31