0%

第二章 学习使用基础语法和GFM扩展语法

[我是开头,引用后面定义的链接][mgj]

md

(下面讲到锚点,点击会跳转到这里)

个人总结:无

摘要:

  第二章主要介绍了Markdown基本语法和最为流行的Github flavored Markdown GFW扩展语法;

那我可就直接写几个语法和示例了

1.底线写法:标题。在Markdown语法中,标题支持两种写法一种是底线,使用-或者=,另一种是使用#。

使用底线的话,只支持一级标题和两级标题,而且-或者=符号至少2个,=标识一级标题,-标识二级标题。

我是一级大标题

我是底线-二级标题

使用#标识,(推荐)
语法格式:# + 空格 + 标题内容
#个数表示标题级数,代表H1-H6,举例:

一级标题

二级标题

六级标题

一般来说,标题前后都要空一行,这样易于阅读。在源码格式下,回车3行。标题前后要赶紧利索,前后不要有空格,也不要有各种标点符号比如分号冒号等。标题尽可能简单,尤其是当生成目录时。

2.粗体和斜体。

Markdown语法中用两个*表示粗体,或者用两个_表示粗体,用一个*或者一个_表示斜体。建议使用星号标识,因为常见且易于阅读。

我是粗体
我是粗体

我是斜体
我是斜体

TIPS:建议粗体、斜体,*中间不要有空格。

  1. 列表。
    列表分为有序列表和无序列表。有序列表使用数字 + 英文逗号 + 空格 + 内容。

无序列表用-或者+或者* + 空格 + 内容,这里建议使用-。

  • 无序1
    1. 回车了一下然后TAB一下,有序1
    2. 有序2
  • 无序2
  • 无序3
  1. 分隔线。
    分割线由3个以上*或者-或者_来表示。个人建议用-来表示,写起来简单。在使用分割线时候,当前行不能有其他字符(可以有空格,但是谁又会那样做呢)



  1. 图片(哎,比较有意思,而且重要)
    好的文章总是图文并茂的,用一句稍稍不雅的话来说:‘无图言DIAO’,图片语法格式如下:
    ![图片代替问题,类似于H5中的图片alt属性,当图片不能显示时文字显示](图片地址 + 空格 + ‘可选的介绍title,怎么理解,就是鼠标悬浮到图片上会看到效果’)
    图片地址支持网络地址、本地地址(可以相对也可以绝对路径)。

Tips:
好记性不如烂笔头,站在岸上学不会游泳,这个是小学学的吧。遇到Markdown图片插入问题,你总不能每次都使用本地图片吧,每次发布或者移动位置都要改动??这时候你需要图床来帮你。图床哦

  1. 链接
    链接也是很常用的,链接分为以下几种:
    1. 文字链接
      语法格式:链接文字
      我是一只破该仔,破呀破该仔

6.2. 引用链接

怎么理解,不好说,感觉第一印象就是H5中的锚点。来实际操作看下效果吧。
[mgj]:https://www.nogit.top

然而,实际用起来,不是锚点,感觉实际场景更像,你好多地方都要跳转一个同一链接,可以事先定义好变量,然后其他地方引用。一处已定义变量,多出引用变量。

6.3. 网址链接

使用一对小于号来表示,<可以输入网址URL或者邮箱>
https://nogit.top

JaneYork1314@163.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
2
def print();
shitf,做的还可以,有点凸显,而且定义了编程语言。
1
System.out.println("要是在写代码块的时候顺便根据编程语言类型,相应地代码提示就好了,貌似sublime text + 插件方法可以。但是又有什么必须呢,你也不会用sublime再根据Markdown来编写代码吧,肯定是从IDE复制编写好**啦**);

8.引用

使用小于号来引用内容,可以理解为引用自己的话。多行引用每行开头都可以加上>,在引用中可以嵌套引用,而且其他语法也可以使用,比如粗体等。

建议在每行引用小于号后加一个空格(这个是文中建议的)
其实我试了试,直接小于号+内容,显示出来效果和小于号 + 一个空额 + 内容,显示效果是一样的,偷懒,我感觉完全没必要,除非是源码格式下,易于阅读。
后来我的意见改了,还是在**小于号加一个空格,太漂亮,易于阅读,而且使用工具比如Typora后回车直接还是按你的格式来(有空格)

另外一个就是,不建议在引用中添加空行

你说气不气人!

我是嵌套引用:语法建议:> + 一个空格 + > + 一个空格 + > + 一个空格

9.转义

顾名思义,老掉牙的东西了,对于特殊符号,不想要被Markdown渲染,要显示在页面上可以用\来操作。
举例:
斜体Markdown语法:* 斜体

下面介绍GFM语法

  1. 删除线
    被删除的文字两端没有空格 哦
  1. 表情符号
    更多表情符号查看:https://www.webfx.com/tools/emoji-cheat-sheet/
    :表情符号代码:
    :cn:
  1. 自动链接
    网络连接,在标准语法中链接需要用、< >来括起来,但是在GFM扩展语法中,会自动识别哦,真是精进了不少。不过貌似只能识别HTTP/HTTPS/WWW开头的。如果不想被识别,可以用``还是tab键位上面那个。
    www.nogit.top
    https://www.nogit.top
  1. 表格
    建议不要使用太多庞大复杂的表格,那样不易于维护和阅读,而且表格中不支持块级元素(代码块、引用块)。
    表格格式:默认左对齐
    表头1 表头2 表头3
    1行1列 1行2列 1行3列
    2行1列 2行2列 2行3列
    左对齐:(均为英文冒号)
    右对齐-:
    居中对齐:-:(好奇怪,看冒号的样子,为什么不叫两端对齐)
  1. 任务列表
    语法格式:
    • 空格 + [空格或者X]
      x可以大写,也可以小写,但是有的编辑器可能不支持大写,所以推荐小写。x代表选中,空格代表不选中。
  • 篮球
    • 大篮球
    • 小篮球
    • 中篮球
  • 足球
  • 排球
  1. 锚点
    终于看到这个了,有点实际作用。尤其是点击目录跳转。
    语法格式:
    锚点描述
  1. 好的排版套路

好的排版看起来真是漂亮。下面简单摘抄几句书中的几句话。
7.1. 一些加空格的情况

- 英文标点符号与后面的字符需要加空格,与前面的空格不需要空格。这点类似于Java代码方法参数定义。

7.2. 不加空格的情况

-中文标点一般和后面都不需要加空格,因为英文标点符号看起来已经有间距了。
  1. 全角和半角
    全角:中文标点符。

有工具帮你检查那是有多爽?VS Code和Typora都可以。

本文使用Windows,typora源码模式编写于2020-03-31