zoukankan      html  css  js  c++  java
  • Markdown 编写技巧汇总(一)

    编写文档,有很多格式选择,也有不同平台选择。下面就自己接触到的MarkDown编写文档的各种技巧做简单梳理,供自己参阅,也希望帮到网友。


    【1】添加空格

     
    

    这种写法比较老土,但是,很实用!注意都是英文状态下的字符,想要多个空格就多复制几次,怎么样的排版都能排上!

    键入全角输入状态下"空格",直接敲击键入即可!
    这种方法很快捷,但也有弊端,不容易在编辑栏中查询修改,建议用一种方式输入空格,尽量避免多种方式混用!

    【2】文字标重

    指的是将文字内容加粗、加背景颜色等视觉效果,以此让文本整体渲染得更好看,也提醒读者一些重要信息。
    加粗 可用** **来标记,如:

    **这是一行被加粗的句子**
    

    斜字 可用* *来标记,如:

    *这是一行倾斜的句子*
    

    粗斜体 可用*** ***来标记,如:

    ***这是一行粗斜体文字***
    

    加底色 可用== ==来标记,如:

    ==这里需要被添加底色==
    

    【3】代码(块)

    单行代码(有时也可作为重标文字来使用):

    你好 a=1 *p=*p1+*p2
    编写方法[ 用`来包裹文字内容]:

    `你好` `a=1` `*p=*p1+*p2`
    

    多行代码 [代码块]:

    int a = 1;
    int b = -100;
    
    void main()
    {
    	int c = a + b;
    	println(c);
    }
    

    使用```来包裹文本,如:

     ```
    int a = 1;
    int b = -100;

    void main()
    {
    int c = a + b;
    println(c);
    }
     ```

    还能定义特定语种,如:
     ```c++

    //这里是c++代码

     ```
    即在首个``` 后面加上语种。

    【4】换行 空行

    空行上键入  ,如:

    我是一行普通的文本
     
     
     
    我也是一行普通的文本
     
    我还是一行普通的文本
    

    得到结果:
    我是一行普通的文本
     
     
     
    我也是一行普通的文本

    我还是一行普通的文本

    键入:<br>

    我是一行普通的文本
    <br>
    我也是一行普通的文本
    <br>
    我还是一行普通的文本
    

    得到结果:
    我是一行普通的文本


    我也是一行普通的文本


    我还是一行普通的文本

    【5】引文

    键入:>,如:

    > 哈哈,我是引文
    

    得:

    哈哈,我是引文

    还能分级显示,如:

    > 我是一级文本
    >> 我是二级文本
    >>> 我是三级文本
    
    >> 我是二级文本
    > 我是一级文本
    

    得到:

    我是一级文本

    我是二级文本

    我是三级文本

    我是二级文本
    我是一级文本

    还能在引文中嵌入代码块:

    > 我是一行文本
    >>  ```
    >>  int a = 0;
    >>  ```
    
    

    得:

    我是一行文本

       int a = 0;  

    【PS】注意`>`后面是可以跟上多行文本的,直到遇到回车换行。如下情况:

    我是一行很长的文本。巴拉巴拉巴拉巴拉巴拉巴拉
    发生的方式方式放松放松故事故事发发怪怪的发说法萨芬的
    分身乏术分身乏术发顺丰撒发顺丰撒方式方法撒飞洒发
    分身乏术发顺丰撒发生的方式。


    发送到方式放松放松发送方师傅。

    写法如下:

    > 我是一行很长的文本。巴拉巴拉巴拉巴拉巴拉巴拉
    发生的方式方式放松放松故事故事发发怪怪的发说法萨芬的
    分身乏术分身乏术发顺丰撒发顺丰撒方式方法撒飞洒发
    分身乏术发顺丰撒发生的方式。
    <br>
    发送到方式放松放松发送方师傅。
    
    

    【6】分割线

    ---
    ***
    ___
    

    即在空行上键入三个及三个以上的*_即可!

    【7】删除线

    被删除的文本

    ~~被删除的文本~~
    

    在文本前后用~~包裹。

    【8】下划线

    带下划线的文本

    <u>带下划线的内容</u>
    

    这是借用了Html5中的标记符号。

    【9】列表

    一、无序列表

    键入* + - 都可[注意后面加个空格],如:

    * 文本1
    * 文本2
    - 文本2
    + 文本3
    

    得到:

    • 文本1
    • 文本2
    • 文本2
    • 文本3

    二、有序列表

    键入1. 2. 10. 等,如:

    1. 文本1
    2. 文本2
    3. 文本3
    10. 文本4
    1. 文本5
    
    

    得到:

    1. 文本1
    2. 文本2
    3. 文本3
    4. 文本4
    5. 文本5

    【PS】这里我故意改写成10.和1.,能够发现markdown系统自动识别列表序号,无关用户写的具体数字。
    当然还可以加入层级,如:

    1. 文本1
    2. 文本2
    	1. 文本4
    	2. 文本5
       2. 文本5
    3. 文本3
    

    得到:

    1. 文本1
    2. 文本2
      1. 文本4
      2. 文本5
      3. 文本6
    3. 文本3

    【PS】有的系统会自动修改标注,加入不同层级的显示。
    需要定义下级的文本,在开头添加一个缩进符tab或者3个以上的空格(太多空格不一定被识别)

    结语

    还有一些高级应用下篇继续。值得说的是,不同的平台,系统配置都有些许差距,得到的效果可能不太一样,属正常现象。

  • 相关阅读:
    20155217 2016-2017-2《java程序设计》第一周学习总结
    20155217杨笛-安装虚拟机
    20155217-杨笛-c与java
    我所期望的师生关系
    jQ学习之实现全选全不选操作
    jQ学习之实现表格的隔行换色
    jQ学习之过滤选择器的测试
    jQ学习之层级选择器的测试
    jQ学习之基础选择器的测试
    jQ学习之实现图片的定时弹出
  • 原文地址:https://www.cnblogs.com/sharpeye/p/15354382.html
Copyright © 2011-2022 走看看