zoukankan      html  css  js  c++  java
  • markdown语法


    前言:

    Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。

    Markdown语法主要分为如下几大部分: 标题,段落,区块引用,代码区块,强调,列表,分割线,链接,图片,反斜杠 ,符号'`'

    一、基础语法

    标题

    文章内容较多时,可以用标题分段,在想要设置为标题的文字前面加#来表示。
    一个#是一级标题,二个#是二级标题,以此类推。可表示1-6级标题。
    标准格式一般在#后跟个空格在写标题,如"# 社会"。

    示例

    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题
    ###### 六级标题
    

    段落/换行

    如果另起一行,只需在当前行结尾加 2 个空格
    若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。


    空行

     
    

    强调

    示例

    **粗体**
    __粗体__
    _斜体_
    

    效果

    粗体
    粗体
    斜体


    代码区块

    通常编辑器根据代码片段适配合适的高亮方法,但你也可以用 ``` 包裹一段代码,并指定一种语言

    ```bash
    void main()
    {
        printf("Hello, Markdown.");
    }
    ```
    

    也可以使用 4 空格缩进,再贴上代码,实现相同的的效果

        void main()
        {
            printf("Hello, Markdown.");
        }
    

    如你不需要代码高亮,可以用下面的方法禁用:

    ```nohighlight
    ```
    

    :需要和普通段落之间存在空行。


    列表

    无序列表

    - 列表文本前使用 [减号+空格]
    + 列表文本前使用 [加号+空格]
    * 列表文本前使用 [星号+空格]
    

    有序列表

    1. 列表前使用 [数字+"."+空格]
    3. 我们会自动帮你添加数字
    1. 不用担心数字编号,显示的时候会自动排序
    

    列表嵌套:

    1. 列出所有元素:
        - 无序列表元素 A
            1. 元素 A 的有序子列表
        - 前面加四个空格
    2. 列表里的多段换行:
        前面必须加四个空格,
        这样换行,整体的格式不会乱
    3. 列表里引用:
    
        > 前面空一行
        > 仍然需要在 > 前面加四个空格
    
    4. 列表里代码段:
    
        ```
        前面四个空格,之后按代码语法 ``` 书写
        ```
    
            或者直接空八个,引入代码块
    

    引用

    普通引用

    > 引用文本前使用 [大于号+空格]
    > 新起一行
    

    引用里嵌套引用

    > 最外层引用
    > > 多一个 > 嵌套一层引用
    > > > 可以嵌套很多层
    

    引用里嵌套列表

    > - 这是引用里嵌套的一个列表
    > - 还可以有子列表
    > * 子列表需要从 - 之后延后四个空格开始
    

    引用里嵌套代码块

    > 同样的,在前面加四个空格形成代码块
    >  
    > ```
    > 或者使用 ``` 形成代码块
    > ```
    

    分割线

    分割线最常使用就是三个或以上,还可以使用-和_。例:" * * " or "- - -"、"_ _ _"
    示例

    ***
    * * *
    - - -
    _ _ _
    

    效果






    删除线

    示例

    ~~删除线~~
    

    效果

    删除线


    链接

    示例

    [孙红雷的博客](https://www.cnblogs.com/sunhongleibibi/)

    效果

    孙红雷的博客


    图片

    添加图片的形式和链接相似,只需在链接的基础上前方加一个!。

    ![自定义名称](imageurl)


    反义符

    如果你的描述中需要用到 markdown 的符号,比如 _ # * 等,但又不想它被转义,这时候可以在这些符号前加反斜杠,如 _ # * 进行避免。

    \_不想这里的文本变斜体\_
    **不想这里的文本被加粗**
    

    折叠栏位

    :有的编辑器好像不支持,本节为扩展学习

    示例:

    <details>
    <summary>这里是折叠标签</summary>
    `这里写代码aaa`
    `这里写代码bbb`
    </details>
    

    展示:

    这里是折叠标签 `这里写代码aaa` `这里写代码bbb`

    隐藏代码

    # 语法
    <!--隐藏-->
    

    二、markdowb表格

    1. 极简方法

    name | 价格 | 数量
    -|-|-
    香蕉 | $1 | 5
    苹果 | $1 | 6
    草莓 | $1 | 7
    

    效果

    name 价格 数量
    香蕉 $1 5
    苹果 $1 6
    草莓 $1 7

    2. 简单

    name | 111 | 222 | 333 | 444
    - | :-: | :-: | :-: | -:
    aaa | bbb | ccc | ddd | eee| 
    fff | ggg| hhh | iii | 000|
    

    效果

    name 111 222 333 444
    aaa bbb ccc ddd eee
    fff ggg hhh iii 000

    3. 原生方法

    name | 111 | 222 | 333 | 444
    :-: | :-: | :-: | :-: | :-:
    aaa | bbb | ccc | ddd | eee| 
    fff | ggg| hhh | iii | 000|
    

    效果

    name 111 222 333 444
    aaa bbb ccc ddd eee
    fff ggg hhh iii 000

    4. 语法说明

    简单方法虽然是稍微简单了些,但是前后因为没有格式所以第一列和最后一列没有居中,对于极简方式来说还相当繁琐。极简方式简单,但是都是左对齐。原生方式格式更美观。个人意见强迫症患者请用原生方式,其他请随意。

    • |、-、:之间的多余空格会被忽略,不影响布局。
    • 默认标题栏居中对齐,内容居左对齐。
    • -:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐。
    • 内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少有一个
  • 相关阅读:
    阿蒂亚谈数学——我对《数学的统一性》的笔记
    陶哲轩实分析习题8.5.6
    陶哲轩实分析习题8.5.2
    陶哲轩实分析习题8.5.9
    陶哲轩实分析习题8.5.5
    陶哲轩实分析习题8.5.6
    陶哲轩实分析习题8.5.2
    陶哲轩实分析习题8.5.1
    陶哲轩实分析习题8.5.9
    陶哲轩实分析习题8.5.5
  • 原文地址:https://www.cnblogs.com/sunhongleibibi/p/11726785.html
Copyright © 2011-2022 走看看