markdown常用语法使用笔记+使用技巧(持续更新......)

参考引用内容: 简书教程

一 基本语法

1. 标题

  • 语法: 在想要设置为标题的文字前面加#来表示,一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。
    注：标准语法一般在#后跟个空格再写文字
  • 示例:
   # 这是一级标题
   ## 这是二级标题
   ### 这是三级标题
   #### 这是四级标题
  • 效果:

2. 字体

  • 语法:
    1. 粗体: 要加粗的文字左右分别用两个*号包起来
    2. 斜体: 要倾斜的文字左右分别用一个*号包起来
    3. 斜体加粗: 要倾斜和加粗的文字左右分别用三个*号包起来
    4. 删除线: 要加删除线的文字左右分别用两个~~号包起来
  • 示例:
   **这是加粗的文字**
   *这是倾斜的文字*
   ***这是斜体加粗的文字***
   ~~这是加删除线的文字~~
  • 效果:
    这是加粗的文字
    这是倾斜的文字
    这是斜体加粗的文字
    这是加删除线的文字

3. 引用

  • 语法:
    在引用的文字前加>即可。引用也可以嵌套，如加两个>>三个>>>
  • 示例:
   >这是引用的内容
   >>这是引用的内容
   >>>这是引用的内容
  • 效果:

    这是引用的内容

    这是引用的内容

    这是引用的内容

4.分割线

用三个或者三个以上的 - 或者 * 或者 _ 表示,分割线会把两端内容分割成两段落,排版都会重新开始

  • 示例:
  • 效果:

分割线

分割线

分割线

5.图片

  • 语法:
![图片alt](图片地址 ''图片title'')
或者使用img标签,可以调整大小
<img src="https://img2018.cnblogs.com/blog/1370059/202002/1370059-20200208164626513-340138758.png" width=60% height=60%  />

图片alt就是显示在图片下面的文字，相当于对图片内容的解释。
图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加

  • 示例:
![美女](http://pic.netbian.com/uploads/allimg/190902/152344-1567409024d50f.jpg "性感图片")
  • 效果:
    美女

6.超链接

  • 语法:
[超链接名](超链接地址 "超链接title")
title可加可不加
或者直接生成链接: <https://gitee.com/houzheng1216>
  • 示例:
[侯赛雷的码云地址](https://gitee.com/houzheng1216)
[侯赛雷的博客地址](https://www.cnblogs.com/houzheng/)
码云地址: <https://gitee.com/houzheng1216>

7.列表

  • 语法:
    无序列表用 - + * 任何一种都可以
    有序列表直接用数字即可,前面符号和数字序号需要跟后面内容有空格
    列表之间嵌套前面需要有 tab空格
  • 示例:
1. 一级有序
   - 二级无序列表
      - 三级无序
      - 三级无序
   - 二级无序列表
   - 二级无序列表
2. 一级有序
   - 二级无序
   - 二级无序
3. 一级有序
  • 效果:
  1. 一级有序
    • 二级无序列表
      • 三级无序
      • 三级无序
    • 二级无序列表
    • 二级无序列表
  2. 一级有序
    • 二级无序
    • 二级无序
  3. 一级有序

8.表格

  • 语法:
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

0) 第二行分割表头和内容。
1）|、-、:之间的多余空格会被忽略，不影响布局。
2）默认标题栏居中对齐，内容居左对齐。
3）-:表示内容和标题栏居右对齐，:-表示内容和标题栏居左对齐，:-:表示内容和标题栏居中对齐,-的数量至少有一个，经过测试，如果表格在某些工具中无法预览，比如idea，则- 至少需要5个，如果还不能预览，则前后都必须写|即可，多试试。
4）内容和|之间的多余空格会被忽略，每行第一个|和最后一个|可以省略。
  • 示例效果:

表头 | 表头 | 表头 | 表头 | 表头

  • | :-: | :-: | :-: | -:
    左对齐 | 居中 | 居中 | 居中居中 | 右对齐
    左对齐左对齐 | 居中居中 | 居中居中 | 居中居中 | 右对齐右对齐

markdown虽然不支持表格嵌套，但是他支持html，所以可以使用HTML实现表格嵌套：
比如代码：

<table>
    <caption><b>品牌选择</b></caption>
	<tr>
	    <th>相机种类</th>
	    <th>品牌</th>
	    <th>特点</th>  
	</tr>
	<tr>
	    <td rowspan="2">单反</td>
	    <td>佳能</td>
	    <td rowspan="2">两个品牌都可以，都很好，没明显区别</td>
	</tr>
	<tr>
	    <td>尼康</td>
	</tr>
	<tr>
	    <td rowspan="3">微单</td>
            <td>奥林巴斯</td>
	    <td colspan="2">防抖强悍，波轮按钮多，不用都操作屏幕</td>
	</tr>
        <tr>
            <td>富士</td>
	    <td colspan="2">色彩漂亮，照片真实</td>
	</tr>
        <tr>
            <td>索尼</td>
	    <td colspan="2">画质好</td>
	</tr>
	<tr>
	    <td rowspan="2">旁轴</td>
	    <td>徕卡</td>
	    <td rowspan="2">旁轴功能较少，不推荐使用</td>
	</tr>
      <tr>
	    <td>富士</td>
	</tr>
	<tr>
	    <td rowspan="1">中画幅相机</td>
	    <td>哈苏</td>
	    <td>中画幅就选哈苏，相机之王</td>
	</tr>
</table>

嵌套效果：

品牌选择
相机种类 品牌 特点
单反 佳能 两个品牌都可以，都很好，没明显区别
尼康
微单 奥林巴斯 防抖强悍，波轮按钮多，不用都操作屏幕
富士 色彩漂亮，照片真实
索尼 画质好
旁轴 徕卡 旁轴功能较少，不推荐使用
富士
中画幅相机 哈苏 中画幅就选哈苏，相机之王

9.符号

  • 反斜杠:\ 相当于反转义作用。使符号成为普通符号:
  • 示例:
<font color=red>红色</font>
\<font color=red>红色</font>
![图片](http://pic.netbian.com/uploads/allimg/190608/130131-1559970091ea9b.jpg)
\!\[图片\]\(http://pic.netbian.com/uploads/allimg/190608/130131-1559970091ea9b.jpg\)
  • 效果:
    红色

<font color=red>红色

图片

![图片](http://pic.netbian.com/uploads/allimg/190608/130131-1559970091ea9b.jpg)

10.代码

  • 语法:
    单行代码使用``括起来
    多行代码使用 三个反引号包起来，且两边的反引号单独占一行
  • 示例:
    `List<Integer> list = Lists.list(1, 2, 3);`
    ```
    @Test
    public void test01Intern(){
        String s = new String("1");//生成堆中对象和常量池中1,常量池中有1
        s.intern();
        String s2 = "1";// 返回常量池引用
        System.out.println(s == s.intern());// jdk1.6 false  jdk1.7以上 false
        System.out.println(s == s2);// jdk1.6 false  jdk1.7以上 false
    }
    ```
  • 效果:
    List<Integer> list = Lists.list(1, 2, 3);
    @Test
    public void test01Intern(){
        String s = new String("1");//生成堆中对象和常量池中1,常量池中有1
        s.intern();
        String s2 = "1";// 返回常量池引用
        System.out.println(s == s.intern());// jdk1.6 false  jdk1.7以上 false
        System.out.println(s == s2);// jdk1.6 false  jdk1.7以上 false
    }

11.mermaid

官方文档教程
mermaid(直译:美人鱼)是Markdown风格的语法，用于生成流程图，序列图，类图，甘特图和git图.
美人鱼功能很强大,能够做的流程图特别多,有兴趣可以去看官方文档,比如做一个简单的流程图:

  • 示例:
代码块开头必须加上mermaid
graph LR;
A --> B
B --> C
C --插入文字--> A
  • 效果:
graph LR; A --> B B --> C C --插入文字--> A

或者再做一个类图:


```mermaid
classDiagram
      Animal <|-- Duck
      Animal <|-- Fish
      Animal <|-- Zebra
      Animal : +int age
      Animal : +String gender
      Animal: +isMammal()
      Animal: +mate()
      class Duck{
          +String beakColor
          +swim()
          +quack()
      }
      class Fish{
          -int sizeInFeet
          -canEat()
      }
      class Zebra{
          +bool is_wild
          +run()
      }
\ ```

效果:

classDiagram Animal <|-- Duck Animal <|-- Fish Animal <|-- Zebra Animal : +int age Animal : +String gender Animal: +isMammal() Animal: +mate() class Duck{ +String beakColor +swim() +quack() } class Fish{ -int sizeInFeet -canEat() } class Zebra{ +bool is_wild +run() }

12.toc

直接在markdown文件第一行写上

目录

  • 示例:
[toc]

博客园可以直接在设置里面自定义标题自动生成目录,就不用每次手动写了!

13. 自定义样式

可以使用html标签进行自定义文字大小颜色等等

  • 示例:
    <font color=blue>蓝色字体</font>

  • 效果:
    蓝色字体

14 视频

<iframe width="720" height="405" frameborder="0" src="https://www.ixigua.com/iframe/6983530617128518177?autoplay=0" referrerpolicy="unsafe-url" allowfullscreen></iframe>

二 使用技巧

  1. 段落之间需要留空格,上下都要留空格,否则会视为同一段落,标题表格等排版会有影响
  2. 如果不用空格,就要使用分割线,表示另起一段
  3. 使用分割线的时候,必须与上面内容之间有空格才会起作用
  4. 美人鱼很强大,但是更推荐xmind那类的软件,贼好用
  5. 同一行文字,两个空格就会自动换行,不需要写其他br标签什么的
  6. 画表格的时候上下都要空一行,否则不会显示
posted @ 2019-12-26 00:13  侯小厨  阅读(1470)  评论(0)  编辑  收藏  举报
Fork me on Gitee