美文网首页
Markdown使用教程

Markdown使用教程

作者: 骑猪追火车 | 来源:发表于2021-05-13 17:03 被阅读0次

    Markdown介绍

    Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
    Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
    Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
    Markdown 编写的文档后缀为 .md, .markdown。

    Markdown应用

    许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等

    Markdown 编辑器

    Markdown常用编辑器Typora,功能强大。

    Typora 官网:https://typora.io/
    你也可以使用我们的在线编辑器来测试:https://c.runoob.com/front-end/712

    一、Markdown 标题

    1.1、使用=和-标记一级和二级标题

    使用方法:
    一级标题展示
    =======
    二级标题展示
    --------

    效果呈现:

    一级标题展示

    二级标题展示

    1.2、使用# 号标记

    使用方法:
    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题
    ###### 六级标题

    效果呈现:

    一级标题

    二级标题

    三级标题

    四级标题

    五级标题
    六级标题

    二、Markdown 段落

    段落:使用两个以上的空格加回车。也可以使用一个空行表示

    2.1、Markdown 字体

    使用方法:

    *斜体文本*
    _斜体文本_
    **粗体文本**
    __粗体文本__
    ***粗斜体文本***
    ___粗斜体文本___

    效果呈现:

    斜体文本
    斜体文本
    粗体文本
    粗体文本
    粗斜体文本
    粗斜体文本

    2.2、Markdown 分割线

    使用方法:
    可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。

    ***
    * * * *
    ----
    ------------------

    效果呈现:





    2.3、Markdown 删除线

    使用方法:
    段落上的文字需要加删除线,只需要在文字两端加上两个波浪线。

    假如给我~~三天~~光明

    效果呈现:

    假如给我三天光明

    2.4、Markdown下划线

    使用方法:
    通过HTML的<u>实现

    <u>带下划线的文本</u>

    效果呈现:

    <u>带下划线的文本</u>

    2.5、Markdown 脚注

    使用方法:
    脚注是对文本的补充说明

    创建脚注格式类似这样 [^baidu]。
    [^baidu]: 百度一下 -- 哪里不会搜哪里!!!

    效果呈现:
    创建脚注格式类似这样 [1]。(脚注在文章最后)

    三、Markdown 列表

    3.1、无序列表

    使用方法:
    使用*、+、-作为标记,后面要添加一个空格,然后写内容。

    * 第一项
    * 第二项
    * 第三项

    + 第一项
    + 第二项
    + 第三项

    - 第一项
    - 第二项
    - 第三项

    效果呈现:

    • 第一项
    • 第二项
    • 第三项
    • 第一项
    • 第二项
    • 第三项
    • 第一项
    • 第二项
    • 第三项

    3.2、有序列表

    使用方法:
    使用数字并加上.号来表示

    1. 第一项
    2. 第二项
    3. 第三项

    效果呈现:

    1. 第一项
    2. 第二项
    3. 第三项

    3.3、列表嵌套

    使用方法:
    列表嵌套只需在子列表中的选项前添加四个空格。

    1. 第一项:
      - 第一项嵌套的第一个元素
      - 第一项嵌套的第二个元素
    2. 第二项:
      - 第二项嵌套的第一个元素
      - 第二项嵌套的第二个元素

    效果呈现:

    1. 第一项:
      • 第一项嵌套的第一个元素
      • 第一项嵌套的第二个元素
    2. 第二项:
      • 第二项嵌套的第一个元素
      • 第二项嵌套的第二个元素

    四、Markdown 区块

    4.1、区块

    使用方法:
    在段落开头使用>符号,加空格。

    > 这是一个区块

    效果呈现:

    这是一个区块

    4.2、区块嵌套

    使用方法:
    一个>是最外层,两个>>是里面一层

    >最外层
    >>第二层
    >>>第三层

    效果呈现:

    最外层

    第二层

    第三层

    4.3、区块中使用列表

    使用方法:

    1. 第一项
    2. 第二项
      + 第一项
      + 第二项
      + 第三项

    效果呈现:

    1. 第一项
    2. 第二项
    • 第一项
    • 第二项
    • 第三项

    4.4、列表中使用区块

    使用方法:
    需要在>前添加4个空格缩进

    * 第一项
    (此处4空格)> 菜鸟教程
    (此处4空格)> 学的不仅是技术更是梦想
    * 第二项

    效果呈现:

    • 第一项

      菜鸟教程
      学的不仅是技术更是梦想

    • 第二项

    五、Markdown 代码

    5.1、代码

    使用方法:
    如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`)。

    'print()' 函数

    效果呈现:

    这是一个代码'print()' 函数

    5.2、代码区块

    使用方法:
    前面添加4个空格或者两个制表符。
    print('hello word!')

    效果呈现:

    print('hello word!')
    

    5.3、指定语言

    使用方法:
    也可以使用'''代码'''包裹住一段代码,并指定一种语言。
    '''Python
    def add(a,b):
    return a+b
    '''

    效果呈现:

    '''Python
    def add(a,b):
    return a+b
    '''

    六、Markdown 链接

    6.1、链接

    使用方法:

    [链接名称](链接地址)
    <链接地址>

    这是一个链接[简书](https://www.jianshu.com/)

    也可以直接使用链接地址
    <https://www.jianshu.com/>

    效果呈现:
    这是一个链接简书

    https://www.jianshu.com/

    6.2、高级链接

    使用方法:
    通过变量来设置一个链接,变量赋值在文档末尾进行。

    这个链接用 1 作为网址变量 [Google][1]
    然后在文档的结尾为变量赋值(网址)
    [1]: http://www.google.com/

    效果呈现:

    这个链接用 1 作为网址变量 Google
    然后在文档的结尾为变量赋值(网址)

    七、Markdown 图片

    7.1、使用链接

    使用方法:
    格式:

    ![alt 属性文本](图片地址)
    ![alt 属性文本](图片地址 "可选标题")

    • 开头一个感叹号!
    • 接着一个方括号,里面是图片名字。
    • 接着放一个普通括号,里面放上图片网址,还可以用因拥包住并加上选择性的title属性文字。

    效果呈现:

    简书图标
    作者头像

    7.2、使用变量

    也可以像网址那样对图片使用变量
    使用方法:
    这个链接用 1 作为网址变量 [Google][1]
    然后在文档的结尾为变量赋值(网址)

    [1]: https://www.google.cn/landing/cnexp/google-search.png

    效果呈现:

    这个链接用 1 作为网址变量 Google
    然后在文档的结尾为变量赋值(网址)

    八、Markdown 表格

    8.1、表格

    使用方法:
    使用|来分割不同的单元格,使用-来分割表头和其他行。

    | 表头 | 表头 |
    | ---- | ---- |
    | 单元格 | 单元格 |
    | 单元格 | 单元格 |

    效果呈现:

    表头 表头
    单元格 单元格
    单元格 单元格

    8.2、对齐方式:

    使用方法:

    • -: 设置内容和标题栏居右对齐。
    • :- 设置内容和标题栏居左对齐。
    • :-: 设置内容和标题栏居中对齐。

    | 左对齐 | 右对齐 | 居中对齐 |
    | :-----| ----: | :----: |
    | 单元格 | 单元格 | 单元格 |
    | 单元格 | 单元格 | 单元格 |

    效果呈现:

    左对齐 右对齐 居中对齐
    单元格 单元格 单元格
    单元格 单元格 单元格

    九、Markdown 高级技巧

    9.1、支持HTML元素

    使用方法:
    支持的元素有:<kbd><b><i><em><sup><br><sub>等。
    使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

    效果呈现:

    使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

    9.2、转义

    使用方法:
    使用反斜杠转义

    **文本加粗**
    \*\* 正常显示星号 \*\*

    效果呈现:

    文本加粗
    ** 正常显示星号 **

    9.3、公式

    使用方法:
    需要插入数学公式时,可以使用两个美元符号$$包裹数学公式。需要进行渲染。

    $$
    \mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
    \mathbf{i} & \mathbf{j} & \mathbf{k} \
    \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \
    \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \
    \end{vmatrix}
    ${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
    $$

    效果呈现:

    \mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\ \end{vmatrix} ${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}


    1. 百度一下 -- 哪里不会搜哪里!!!

    相关文章

      网友评论

          本文标题:Markdown使用教程

          本文链接:https://www.haomeiwen.com/subject/koatjltx.html