java-basic

Markdown 简介、语法及常用编写工具

2020-05-15  本文已影响0人  anlostsheep

简介

语法

  1. 标题

    Markdown 语法中的标题可以有六级

    # 一个 '#' 符号表示一级标题
    ## 两个 '#' 符号表示二级标题
    ### 三个 '#' 符号表示三级标题
    #### 四个 '#' 符号表示四级标题
    ##### 五个 ‘#’ 符号表示五级标题
    ###### 六个 '#' 符号表示六级标题
    
    • 效果:

    一级标题

    二级标题

    三级标题

    四级标题

    五级标题
    六级标题
  2. 段落

    • 段落的前后要有空行,所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。
  3. 引用

    Markdown 语法中使用 '>' 符号开启应用

    > 在每个段落的每行行首使用 '>' 为一整段落的引用,
    > > 嵌套使用 '> >' 可以在段落引用中追加引用
    
    • 效果:

    区块引用

    嵌套引用

  4. 代码块

    代码区块的建立是在每行加上 4 个空格或者一个制表符(如同写代码一样),如

    普通代码:
    
    public static void main(String[] args){
        System.out.print("Hello, Markdown.");
    }
    
    开启代码段落:
    
    ​```java
    public static void main(String[] args){
        System.out.print("Hello, Markdown.");
    }
    ​```
    
    • 效果:

    public static void main(String[] args){
    System.out.print("Hello, Markdown.");
    }

  public static void main(String[] args){
      System.out.print("Hello, Markdown.");
  }

注意点:普通段落和使用 Markdown 符号的段落需要空行

  1. 强调

    Markdown 语法中使用 '**<文字>**' 来加粗文字
    eg: **加粗文字**
    
    Markdown 语法使用 '*<文字>*' 来使文字斜体
    eg: *斜体文字*
    
    Markdown 语法使用 '***<文字>***' 加粗并斜体文字
    eg: ***加粗且斜体文字***
    
    Markdown 语法使用 '~~<文字>~~' 给文字加上删除线
    eg: ~~删除文字~~
    
    • 效果:

    加粗文字

    斜体文字

    加粗且斜体文字

    删除文字

  2. 分割线

    分割线最常使用就是三个或以上*,还可以使用-_

    ---
    ----
    ***
    *****
    
    • 效果:




  3. 链接

    Markdown 语法使用 [baidu](https://www.baidu.com) 标识一个网页链接

    eg: [简书](https://www.jianshu.com/)
    
    • 效果:

    简书

  4. 图片

    Markdown 语法使用 ![图片]()

    ![黄图](https://ss0.bdstatic.com/94oJfD_bAAcT8t7mm9GUKT-xh_/timg?image&quality=100&size=b4000_4000&sec=1589531790&di=8c9318780942cf59dda0cf30623ade6b&src=http://www.dachuantuan.com/uploadfile/2018/0129/20180129093127673.jpg)
    
    • 效果:
黄图.jpg

小声哔哔:后续文章出如何白嫖图床(图片服务器)

  1. 列表

    • 有序列表

      有序列表使用符号 1., 2., 3. ... 开启有序列表

      1. 一级列表头
      2. 二级列表头
      3. 三级列表头
      ...
      
    • 无序列表

      无序列表用 -, +, * 任何一种都可以

      - 列表内容
      + 列表内容
      * 列表内容
      
      注意:- + * 跟内容之间都要有一个空格
      
    • 效果:

      1. 列表1
      2. 列表2
      3. 列表3
      • 无序列表1
      • 无序列表2
      • 无序列表3

    提醒: 有序和无序列表均可以嵌套使用,即可以在无序或有序的列表中的下级列表中继续使用

  2. 表格

    Markdown 语法中使用表格语法:

    | 表头 | 表头 | 表头 |
    | :-: | :-: | :-:  |
    |行1列1|行1列2|行1列3|
    
    第二行分割表头和内容。
    - 有一个就行,为了对齐,多加了几个
    文字默认居左
    - 两边加:表示文字居中
    - 右边加:表示文字居右
    
    • 效果

      表头 表头 表头
      行1列1 行1列2 行1列3
  3. 反斜杠 \

    相当于反转义的符号,将标记符号变成普通符号

    \**不变粗**
    
    • 效果:

      *不变粗*

  4. 标记符号 '`'

    '`' 此符号起到标记作用
    eg: `标记一下`
    
    • 效果:

      标记你了

  5. 流程图

    ​```flow
    st=>start: 开始
    op=>operation: My Operation
    cond=>condition: Yes or No?
    e=>end
    st->op->cond
    cond(yes)->e
    cond(no)->op
    ​```
    
    • 效果:
    st=>start: 开始
    op=>operation: My Operation
    cond=>condition: Yes or No?
    e=>end
    st->op->cond
    cond(yes)->e
    cond(no)->op
    

    注意Markdown 的流程图语法在一些支持 Markdown 语法的网站或编辑器上不一定支持,或是它们有自己的实现 Markdown 流程图的语法

上一篇 下一篇

猜你喜欢

热点阅读