zoukankan      html  css  js  c++  java
  • Markdown 编辑器指南

    一直觉得博客园默认的编辑器不好用,后来了解了Markdown,并且博客园也支持Markdown标记,所以写篇博客总结下。


    一、认识 Markdown

    Markdown 是一种用来写作的轻量级「标记语言」,它用简洁的语法代替排版,而不像一般我们用的字处理软件 Word 有大量的排版、字体设置。它使我们专心于码字,用「标记」语法,来代替常见的排版格式。例如此文从内容到格式,甚至插图,键盘就可以通通搞定了。

    优点:
    1、因为是纯文本,所以只要支持Markdown的地方都能获得一样的编辑效果,可以让作者摆脱排版的困扰,专心写作。
    2、操作简单。比如:Word编辑时标记个标题,先选中内容,再点击导航栏的标题按钮,选择几级标题。要三个步骤。而Markdown只需要在标题内容前加#即可。

    缺点:
    1、需要记一些语法(当然,是很简单。五分钟学会)。
    2、有些平台不支持Markdown编辑模式。


    二、Markdown 基本语法

    2.1 标题

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

    示例:

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

    由于我重新设置了博客园的标题相关CSS,显示的标题不再是博客园默认的样式,所以这里就不展示效果了。

    注:标准语法一般在#后跟个空格再写文字,但也有些网站的编辑器不加空格也行。


    2.2 字体

    • 加粗

      要加粗的文字左右分别用两个*号包起来

    • 斜体

      倾斜的文字左右分别用一个*号包起来

    • 斜体加粗

      要倾斜和加粗的文字左右分别用三个*号包起来

    • 删除线

      要加删除线的文字左右分别用两个~~号包起来

    示例:

    **这是加粗的文字**
    *这是倾斜的文字*`
    ***这是斜体加粗的文字***
    ~~这是加删除线的文字~~
    

    效果:

    这是加粗的文字
    这是倾斜的文字`
    这是斜体加粗的文字
    这是加删除线的文字


    2.3 引用

    在引用的文字前加>即可。引用也可以嵌套,如加两个>>,加三个>>>,n个...;貌似可以一直加下去,但没神马卵用。

    示例:

    >这是引用的内容
    >>这是引用的内容
    

    效果:

    这是引用的内容

    这是引用的内容


    2.4 分割线

    三个或者三个以上的 - 或者 * 都可以。

    示例:

    ---
    

    效果:



    2.5 图片

    语法:

    ![alt 属性文本](图片地址 "可选标题")
    
    • 开头一个感叹号 !
    • 接着一个方括号,里面放上图片的替代文字
    • 接着一个普通括号,里面放上图片的网址,最后的"可选标题"是当鼠标移到图片上时显示的内容

    示例:

    ![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png "RUNOOB")
    

    效果:

    RUNOOB 图标


    2.6 链接

    语法:

    [链接名称](链接地址 "链接title")
    title可加可不加
    

    示例:

    [博客园](https://www.cnblogs.com/)
    

    效果:

    博客园


    注:Markdown本身语法不支持链接在新页面中打开,如果想要在新页面中打开的话可以用html语言的a标签代替。

    <a href="超链接地址" target="_blank">超链接名</a>
    
    ## 示例
    <a href="https://www.cnblogs.com/" target="_blank">博客园</a>
    

    2.7 列表

    Markdown 支持有序列表和无序列表,并且支持列表嵌套。

    无序列表

    无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记:

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

    效果:

    • 列表内容

    • 列表内容

    • 列表内容


    有序列表

    有序列表使用数字并加上 . 号来表示,如:

    1. 列表内容
    2. 列表内容
    3. 列表内容
    
    ## 注意:序号跟内容之间要有空格
    

    效果:

    1. 列表内容
    2. 列表内容
    3. 列表内容

    列表嵌套

    列表嵌套只需在子列表中的选项添加四个空格即可:

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

    效果:

    1. 第一项:

      • 第一项嵌套的第一个元素

      • 第一项嵌套的第二个元素

    2. 第二项:

      • 第二项嵌套的第一个元素
      • 第二项嵌套的第一个元素

    2.8 表格

    Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。

    示例:

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

    效果:

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

    2.9 代码

    单行代码

    单行代码:代码之间分别用一个反引号包起来。

    示例:

    `代码内容`
    

    效果:

    代码内容


    代码块

    代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行。

    示例:

    ​```
    int main (int argc, char *argv[])
    {
    	return 0;
    }
    ​```
    

    效果:

    int main (int argc, char *argv[])
    {
        return 0;
    }
    

    参考:

    菜鸟教程-Markdown 教程

    Markdown基本语法


  • 相关阅读:
    分布式文件系统技术选型
    .net core 与nginx笔记
    分布式场景
    c printf函数
    c 编程范式
    VS2019 卡顿,甚至卡死
    SQL Server 跨服务器查询
    递归 0到100求和
    moment js 制作倒计时 比较简单
    关于地狱回调的理解
  • 原文地址:https://www.cnblogs.com/linuxAndMcu/p/11212486.html
Copyright © 2011-2022 走看看