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

参考引用内容: 简书教程

一 基本语法

1. 标题

  • 语法: 在想要设置为标题的文字前面加#来表示,一个#是一级标题,二个#是二级标题,以此类推。支持六级标题。

    注:标准语法一般在#后跟个空格再写文字
  • 示例:
   # 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
  • 效果:

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

2. 字体

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

    这是加粗的文字

    这是倾斜的文字

    这是斜体加粗的文字

    这是加删除线的文字

3. 引用

  • 语法:

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

    这是引用的内容

    这是引用的内容

    这是引用的内容


4.分割线

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

  • 示例:

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

分割线


分割线


分割线


5.图片

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

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。

图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

  • 示例:
![美女](//bbsmax.ikafan.com/static/L3Byb3h5L2h0dHAvcGljLm5ldGJpYW4uY29tL3VwbG9hZHMvYWxsaW1nLzE5MDkwMi8xNTIzNDQtMTU2NzQwOTAyNGQ1MGYuanBn.jpg "性感图片")
  • 效果:

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

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)-:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐,-的数量至少有一个。
4)内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略。
  • 示例效果:
表头 表头 表头 表头 表头
左对齐 居中 居中 居中居中 右对齐
左对齐左对齐 居中居中 居中居中 居中居中 右对齐右对齐

9.符号

  • 反斜杠:\ 相当于反转义作用。使符号成为普通符号:
  • 示例:
<font color=red>红色</font>
\<font color=red>红色</font>
![图片](//bbsmax.ikafan.com/static/L3Byb3h5L2h0dHAvcGljLm5ldGJpYW4uY29tL3VwbG9hZHMvYWxsaW1nLzE5MDYwOC8xMzAxMzEtMTU1OTk3MDA5MWVhOWIuanBn.jpg)
\!\[图片\]\(//bbsmax.ikafan.com/static/L3Byb3h5L2h0dHAvcGljLm5ldGJpYW4uY29tL3VwbG9hZHMvYWxsaW1nLzE5MDYwOC8xMzAxMzEtMTU1OTk3MDA5MWVhOWIuanBn.jpg\)
  • 效果:

    红色

<font color=red>红色

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

![图片](//bbsmax.ikafan.com/static/L3Byb3h5L2h0dHAvcGljLm5ldGJpYW4uY29tL3VwbG9hZHMvYWxsaW1nLzE5MDYwOC8xMzAxMzEtMTU1OTk3MDA5MWVhOWIuanBn.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>

  • 效果:

    蓝色字体


二 使用技巧

  1. 段落之间需要留空格,上下都要留空格,否则会视为同一段落,标题表格等排版会有影响
  2. 如果不用空格,就要使用分割线,表示另起一段
  3. 使用分割线的时候,必须与上面内容之间有空格才会起作用
  4. 美人鱼很强大,但是更推荐xmind那类的软件,贼好用
  5. 同一行文字,两个空格就会自动换行,不需要写其他br标签什么的
  6. 画表格的时候上下都要空一行,否则不会显示
上一篇:Configure a welcome page in Struts


下一篇:RecyclerView 下拉刷新上拉加载