Markdown语法学习


Markdown初探

10148

导读

前面已经介绍了如何生成一个Hexo 博客,也简单的介绍了写博客使用的工具Typora .

那什么是Typora ?它是一个所见即所得的markdown工具.

那什么是markdown?它的基本语法是什么?这是下面我们主要介绍的.

什么是markdown

Markdown 是目前互联网上最流行的写作语言,它使用一些简单的符号(* / ` > [] () #)来标记文本格式,其简洁的语法、优美的格式以及强大的软件支持深受广大网友的喜爱。

维基百科上对 Markdown 的描述:

Markdown 是一种轻量级标记语言,创始人是约翰·格鲁伯(John Gruber)。它允许人们 “使用易读易写的纯文本格式编写文档,然后转换成有效的 HTML 文档。”

大家千万不要被一些专业术语唬住了,其实 Markdown 之所以流行,最主要的原因就是因为它的学习门槛很低,你可能只需花几分钟就可以入门了。

如何写markdown

在练习写markdown之前,我建议你下载一个typora ,因为他所见即所得,你可以一边写一边对照源码.当然了市面上也存在着很多的markdown编辑器.这个看个人的喜好,可以自己去尝试其他的编辑器.

typora:https://typora.io/

注意:markdown文件都是以.md 结尾的.可以下载语法文件(https://github.com/ningwenyan/MyNote/blob/master/MarkDown初探.md),对照练习.

10149

基本语法

使用该文件测试和展示Github的markdown语法。
Githubmarkdown语法在标准的语法上做了补充,称为Github Flavored Markdown.简称GFM,GFM在Github上有广泛的应用,README,issues和wiki都支持markdown语法.


目录




***,---,___都用来表示分割线

语法使用效果
***,---,___分割线(用在一行开头)
#一级标题标题
##二级标题标题
###三级标题标题
####四级标题标题
#####五级标题标题
######六级标题标题
普通文本直接输入普通文本
单行文本在一行的开头就一个tab
或者4个空格
单行文本
文本块语法一:在连续几行的文本开头加tab或4个空格
语法二:使用一对各三个的反引号
文本块
文本高亮使用一对反引号linux 学习
换行直接回车不能换行,可以在两行文本之间补一个空行
使用换行符<br>
a
br
*斜体1*斜体1
_斜体2_斜体2
**粗体1**粗体1
__粗体2__粗体2
这是一个 ~~删除线~~这是一个 删除线
***斜粗体1***斜粗体1
___斜粗体2___斜粗体2
***~~斜粗体删除线1~~***斜粗体删除线1
~~***斜粗体删除线2***~~斜粗体删除线2
斜体,粗体,删除线可以直接混合使用
![alt](URL title)alt:显示图片失败时显示的文本
URL title:
URL:图片的URL地址,如果是仓库中的图片,
直接使用相对路径就可以了,如果是其他仓库中的图片要注意格式,仓库地址/raw/分支名/图片路径
title:鼠标停留在图片上时显示的文字
![google](https://www.google.com/
images/logo.gif "goolge")
google
链接链接外部URL [alt](URL title)
alt是显示在屏幕上的连接名
[谷歌](www.google.com)
谷歌
锚点其实每个标题都是一个锚点,和THML的锚点#类似
[create an anchor](#anchors-in-markdown)
比如最上面定义了一个目录可以回到目录
定义为:[回到目录](#目录) 详细介绍
有序列表详细效果
多级有序列表详细效果
无序列表使用+,*,-都可以表示详细效果
复选框列表详细效果
表格
多级表格多级表格
diff语法与代码高亮类似,替换代码类型为diff即可diff语法
表情GFM支持出入表情输入不同的冒号符(两个冒号包围的字符)可以显示出不同的表情
官方查询

标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

普通文本

普通文本


单行文本

(在一行的开头加一个tab或者是4个空格)
hello world

文本块
文本块
文本块

文本块

文本块
文本块
文本块

锚点

https://www.zhihu.com/

功能/语法:

    1. It downcases the string
    2. remove anything that is not a letter, number, space or hyphen (see the source for how Unicode is handled)
    3. changes any space to a hyphen.
    4. If that is not unique, add "-1", "-2", "-3",... to make it unique

如上所示,对于标题为
#What is LaTeX?
正确的链接方式是
[What is LaTeX?](#what-is-latex)
同理:[Ready, set, GO!](#ready-set-go)
使用这样的方式就可以实现Markdown的目录了。

多级表格

第一步:从word或excel中复制表格
第二步:打开此链接
第三步:贴上复制的文字,然后按convert,就会得到这个表格的代码:
第四步: 将代码粘贴到markdown中就可以显示出来


有序列表

格式为数字+ 英文符号. +空格 +名称来表示
注意. 后面的空格

  1. 第一
  2. 第二
  3. 第三

多级有序列表

相同与有序列表,只要错开即可
注意. 后面的空格

  1. 第一
    1. 第二
      1. 第三

无序列表

注意空格分隔开

+ 1
+ 2
+ 3 

- 1
- 2

* 1 
* 2
  • 1

  • 2

  • 3

  • 1

  • 2

  • 1

  • 2

复选框

  • 1
  • 2
  • 3
注意空格隔开
- [x] 1
- [x] 2
- [ ] 3

diff语法

GFM中可以 显示 diff效果,绿色表示新增,红色表示删除

+  新增加
-  新删除


文章作者: 文彦
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 文彦 !
评论
  目录