Fork me on GitHub Markdown基本语法 - 冰路梦 | binglumeng
Markdown

Markdown基本语法

Posted by 冰路梦 on 2016-09-26

Markdown 基本语法

本文没有使用csdn的markdown书写，而是原语法格式显示，便于更好的理解markdown语法。
目前本人发现的比较不错的markdown编辑器：tepora、atom、Haroopad、以及在线版的cmdMarkdown、马克飞象、Stack Edit等。
文章结尾附上本文的markdown形式。

一、标题

1. 类似Setext形式，利用 = 或 - 符号，写在标题文字下一行，分别表示一级、二级 标题

注 : =或-至少也只需要两个就好。

2.类似Atx形式，使用 # 符号，加与标题文字前，且至少一个空格才行使用个数1～6,分别表示六级标题

注 : 标签语言讲究对称性，标题Atx模式可以在标题后加上不定个数的#，仅为美观而已。

markdown编辑文字需要有空行，才能显示为空行，而换行需要编辑时有一个空行

显示才会换行。编程通则，符号输入法英文半角。

二、区块引用

markdown使用类似email中的 > 引用符号，标记区块
区块内的每一行都会自动添加 > 符号
其实也可以仅在第一行使用了 > 符号即可，不过有些编辑器会自动补上。

但是这样的话就需要有一个空行，才能表示区块结束。若是最后一行有 > 符号，
想要结束区块就要回车后，空一行，再回来哦，表示中断和区块编辑的联系。

区块内也可以使用嵌套

嵌套层级应该是没有限制的

多级嵌套
也是挺好看的

但是想要结束一个小区块，就得借助空行了。
不然还真的不好结束呢。外层区块与其他区块之间，
看来需要有非区块语法隔离才行。

使用了一个分割线才和上面的区块分开来，空格，空行，回车都没用的哦。
区块内可以使用其他markdown的语法。

来个标题

背景条幅

三个—即可形成一个分割线，注意和上面文字空一行，否则就成标题了哦

三、列表

  • 列表分为无序列表和有序列表，可以多级列表。
- 无序列表中使用 加、减、星号
   * 来作为开启列表的标识,均需要有一个空格才生效。或者tab也行
  1. 有序列表使用数字
    1. 和英文的句号，数字不一定就要一二三的很有序。
  1. 显示时候都是123的。
  2. 多个段落的隔开，需要每个段前tab或4空格？有点乱，感觉首列后空一行
    则每列都会空，非首列则空其后。
  3. 列表内使用引用符号>，需要缩进
    1. 还是列表内容

      引用，我似乎没感觉到？

  1. 如果列表放入代码，该区快就要缩进两tab或8空格
    1
    2
    3
    public static void main(String[] args){
     System.out.pringtln("代码高亮");
    }

1.可能无意间会写出列表形式，比如首行“2016. 09. 25”出现了数字，句点和空格
就会形成列表，如此可以加个\来避免，或者其他符号。
注意和普通文本的编辑不同，列表的缩进，需要在列表标识符号前加空格，最多三个。
其后面需至少一个空格或tab

2.文字段落前一个tab或4个空格，就会生成背景框。
和用``符号似乎不太一样，这个有点加黑得样子？

四、代码区块

1,代码区块得建立就是面所说，一个tab或者4个空格。
而在带码区块中，markdown的一般语法符号，将只是普通文本。

1
2
3
public static void main(String[] args){
    System.out.pringtln("代码高亮");
}//哎呦，后面的```引号，还不到能直接放在这一行呢，否则就不算结束代码块了。

五、分割线

在一行中使用三个或以上的星号、减号、下划线，就可以显示一个分割线
但是需要从行首就开始,可以混用,(不同的md编辑器，也许细节不同)且不必连续，但不能掺杂文字

而且要注意避免形成标题哦，

六、区段元素

1、链接

Markdown 支持两种链接：行内式和参考式。链接文字都用[方括号]标记。

  • 行内式，[]后跟(url “网址标题”)即可。
    baidu，前面式显示网址，””内部式网址标题
    • 似乎也可以使用路径形式,file。
  • 参考式，两个[name][id]，前面为显示名称，id为标记变量名，在文章内任意文本首行位置
    声明 [id]:www.baidu.com,即可。
    *例如，百度,网址在此显示，地址声明如下，
    注意缩进什么的不要与其他语法冲突而失效。

此种链接内容的格式，选择性的3个空格，一个冒号，一个tab或空格，然后是网址，
后面的标题title，可以用单引号，双引号，或者括号都行。
注，网址可以用<>包括，标题可以另起一行。链接不区分大小写，字母数字，空白和标点。
隐式链接标记功能，可以省略指定连接。此时视为文字为网址，[id]就空这，name等于id了。

如此形式，name可以多单词，加空格。
thinkpad lenovo,

参考式链接可以像文献引用一样，放于文后，便于整洁。

七、强调

Markdown用*或_来标识强调，位于其包围内的文本，被强调显示，两个**或__,会更强吗？
此处为了显示单个的*而不是和后面的一起作用，用了\做转义。

  • 如下
    • 单个强调,和强调单个，是加黑斜体
    • 双星强调，更厉害
    • 那么三星更厉害吗,最多可用四个，但是没啥区别了。
      你混合失效，且符号两边不能有空格。前边的不能空？
  • 强调单个
  • 删除线，nihao

八、代码及符号

原来背景是用来标记小行段代码的，用反单引号``标记，代码写在其中。
要是代码内也有``符号，那么外围可以多用几个``符号
例如

1
2
3
4
___
使用反引号时候，紧跟代码语言，即可实现代码高亮
最外围的\```  内部各加一个空格，里面的引用就可以直接一开始添加更多的\```了
```  ``使用反引号

$$注意使用标签标识符的时候，前后的位置个数要一致，尤其小心缩进与空格的影响$$
$d$

#d

$$你好#$$

$$nihao_$$

$$nihao^$$

$$nihao$$
$$nihao%$$
$$nihao@$$
$$nihao~$$
$$nihao{$$
1、markdown语法会自动规避一盒html的标签，比如&，[]之类的

九、图片

1、Markdown 使用和链接类似得方式处理图片，行内式和参考式，用！作为标记，加[name]和(path)

  • 行内式，img1,小心写成链接哦img2
  • 参考式，img2

暂时没法指定宽高，可以用html的< image > 标签,此处加空格，否则就不显示了。颜色字体什么的
就看html的形式了。

十、其他

1、自动链接，Markdown 转译简短得自动链接或邮箱
http://www.baidu.com/,markdown@mk.cn
2、反斜杠，转义符号，可用于一下符号转义为普通

\
`
*
_
{}
[]
#
+
-
.
!
这几种符号得转义。

<! html 的标签，似乎会被隐藏,不同编辑器略有不同哦，<> >
空格空格加回车，才是换行符。

表格

Markdown　Extra　表格语法：独立行开始，写title，用|分割，然后次行用－符号，并配合|，如此构成表格。

项目 价格
Computer $1600
Phone $12
Pipe $1

可以使用冒号来定义对齐方式：
：—表示左对齐，—：表示右对齐，：—：表示居中对齐。

项目 价格 数量
Computer 1600 元 5
Phone 12 元 12
Pipe 1 元 234
  • 试试表格，至少要有表头和一个－标识列才行哦。
表头
  • 复选框，使用空格-/*/+空格[x]空格 项目，表示选中,类似列表选项。
    • [x] 第一条
    • [ ] 第二条
  • 表情，使用冒号包围表情的英文代号

其他拓展

  • CSDN

    1. 脚注，类似链接，使用[^id]声明，其他地方[^id]:解释。
    2. 目录，[toc]标签

    3. UML图，类似代码块，不过反单引号后面申明的不是编程语言，而是图的类型

      1. 如

        1
        2
        3
        张三->李四: 嘿，小四儿, 写博客了没?
        Note right of 李四: 李四愣了一下，说：
        李四-->张三: 忙得吐血，哪有时间写。
        1. 流程图
          1
          2
          3
          4
          5
          6
          7
          st=>start: 开始
          e=>end: 结束
          op=>operation: 我的操作
          cond=>condition: 确认？
          st->op->cond
          cond(yes)->e
          cond(no)->op

    4. 列表的定义与基本语法不同，使用: 项目来缩进列表项。

    5. 数学公式，如下
      使用MathJax渲染LaTex 数学公式，详见[math.stackexchange.com].
    • 行内公式，数学公式为：$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$。
    • 块级公式：
      $$x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

  • Gitlab

    1、网址直译，www.baidu.com

2、文件对比，不同,使用花括号和中括号的配合
，不能同时使用同一个哦。{+ ADD +] and [-delete-}
3、gitlab引用，@user_name,#123,等等。

####CmdMarkdown ^cmd

  • 高效绘制 流程图，标识为flow

    1
    2
    3
    4
    5
    6
    7
    8
    st=>start: Start
    op=>operation: Your Operation
    cond=>condition: Yes or No?
    e=>end
    st->op->cond
    cond(yes)->e
    cond(no)->op

  • 高效绘制 序列图，其标识为sequence

1
2
3
Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!
1
2
3
4
5
6
7
8
9
10
11
12
13
title 项目开发流程
section 项目确定
    需求分析       :a1, 2016-06-22, 3d
    可行性报告     :after a1, 5d
    概念验证       : 5d
section 项目实施
    概要设计      :2016-07-05  , 5d
    详细设计      :2016-07-08, 10d
    编码          :2016-07-15, 10d
    测试          :2016-07-22, 5d
section 发布验收
    发布: 2d
    验收: 3d

注：markdown可以直接使用许多html的标签，用于更为丰富的界面显示哦。
本人记录Markdown 语法用于个人学习，难免有疏漏，请读者见谅指点
本文参考Markdown语法,在此感谢。
FEATURED TAGS
Markdown
FRIENDS