zoukankan      html  css  js  c++  java
  • Markdown,你只需要掌握这几个

    题记

      为什么使用Markdown?这是一个问题。答案有很多种。比如,不局限于格式啦,比如.xls文档得用excel打开吧,.doc文档得用word打开吧,.xxx得用xxx打开吧。如果你机子上没有这个软件,岂不是抓瞎了,还能不能愉快的学习了?!因此你需要一种能使用简单的文本编辑器就可以书写,有浏览器就可正常显示的格式或标记,Markdown很适合哦。什么,这个理由不好?那么就权当是装B吧,你说你用Markdown写文档,是不是逼格一下就上去了。(哎,估计也只有我这种新手才用来炫耀,大牛都是不屑的。)


    正文

    二八定律说:

    百分之二十的知识解决百分之八十的问题。

      其实你只需要掌握基本语法标记就可以愉快的玩耍了。经过几个月使用Markdown写文档,发现掌握下面这些标记语法,就可以完成日常文档书写了。什么?要画流程图?这些需求对于大部分时间来说,你是用不到的,你只需要建立一个知识储备就好。遇到了想不起来?打开看一下就是了。想记住?对不起,这种事倍功半的事情,还是少做为妙,毕竟时间是硫酸,管你是什么都能够腐化,只是快慢而已。
      那么问题来了,为什么这几个常用的要记住呢?因为这几个是经常使用的,虽然熟能生巧,日久便记住了,但是在熟能生巧的路上总不能天天翻看知识储备吧。太影响效率。何不花一点点时间强行记住,那么在日久记住的道路上,岂不是一路顺风?闲话不多说,来看看你要掌握的语法标记吧。如果你想学习和使用Markdown,我建议:

    • __常用标记__要先花一些时间熟记,后面经常使用的话就会形成习惯了,不过脑的正常书写,跟打字一样;
    • __次常用标记__要有基本的印象,能记住也是可以的;
    • __不常用标记__和专用标记just看看就好,等到使用的时候百度一下,你就知道

    1. 常用标记

    1.1 标题

    1.1.1 说明
    • 使用#表示标题,一级标题使用一个#,二级标题使用两个##,以此类推,共有六级标题。
    • 使用=====表示高阶标题,使用---------表示次阶标题。
    1.1.2 示例
    # 这是一级标题
    ## 这是二级标题
    ### 这是三级标题
    ###### 这是六级标题
    
    这是高阶标题(效果和一级标题一样 )
    ========
    
    这是次阶标题(效果和二级标题一样)
    --------------
    

    这是一级标题

    这是二级标题

    这是三级标题

    这是六级标题

    这是高阶标题(效果和一级标题一样 )

    这是次阶标题(效果和二级标题一样)

    1.1.3 注意
    1. #和标题之间最好加一个空格。不要问我为什么,貌似有时候不会被识别为标题?已经忘记自己为什么要加空格了,也许是任性。
    2. ====----表示标题时,大于等于2个都可以表示。
    3. 我通常在标题分级时使用标题标记,这个的用处很明了了。

    1.2 目录

    1.2.1 说明

    使用[TOC]生成目录。如一开始的目录所示。

    1.2.2 示例
    [TOC]
    

    1.2.3 注意
    1. 如果你的标题都是按照Markdown语法书写的话,可以自动生成层级目录。
    2. 我常用 为知笔记 记笔记,可惜为知笔记不支持
    3. [TOC] 标记可能只能放在一级标题的前面,视不同的编译器而定。

    1.3 引用

    1.3.1 说明

    使用>表示引用,>>表示引用里面再套一层引用,依次类推。

    1.3.2 示例

    例1:

    > 这是一级引用
    >>这是二级引用
    >>> 这是三级引用
    
    >这是一级引用
    

    这是一级引用

    这是二级引用

    这是三级引用

    这是一级引用

    例2:

    > 这是一级引用
    >>这是二级引用
    >>> 这是三级引用
    >这是一级引用
    

    这是一级引用

    这是二级引用

    这是三级引用
    这是一级引用

    1.3.3 注意
    1. 如果>>>嵌套使用的话,从>>退到>时,必须之间要加一个空格或者>作为过渡,否则默认为下一行和上一行是同一级别的引用。如示例所示。
    2. 引用标记里可以使用其他标记,如:有序列表或无序列表标记,代码标记等。
    3. 我通常在引用别人的话或者某些时候做说明时使用引用标记,其实我一直拿不准到底什么情况下使用引用标记才是正确的。如果你知道,我只想说:请务必告诉我。

    1.4 代码块

    1.4.1 说明

    使用```表示代码块。

    1.4.2 示例

    ```javascript
    var canvas = document.getElementById("canvas");
    var context = canvas.getContext("2d");
    ```

    var canvas = document.getElementById("canvas");
    var context = canvas.getContext("2d");
    
    1.4.3 注意
    1. `这个符号是在Esc键下面,切换到英文下即可。
    2. ```后面的javascript表示此段代码为javascript代码,Markdown会自行使用javascript代码颜色渲染。这里也可以不写。PS:谁能够提供一个完整的Markdown可以渲染的语言列表啊,比如:linux命令这里写什么?
    3. 本文档所有使用讲解Markdown语法标记示例的地方都是使用代码块标记的。

    1.5 行内代码

    1.5.1 说明

    使用``表示行内代码。

    1.5.2 示例
    这是`javascript`代码
    

    这是javascript代码

    1.5.3 注意
    1. 本页部分文字中间的英文字母就是使用行内代码标记标记的。
    2. 这个的使用场景我也有些模糊。我常在文字间有英文的时候使用,但有时又不知道该不该使用,困扰。如果你知道,请告诉我。

    1.6 导入图片

    1.6.1 说明

    使用![Alt text](/path/to/img.jpg "Optional title")导入图片。其中:

    • Alt text为如果图片无法显示时显示的文字;
    • /path/to/img.jpg为图片所在路径;
    • Optional title为显示标题。显示效果为在你将鼠标放到图片上后,会显示一个小框提示,提示的内容就是 Optional title里的内容。
    1.6.2 示例
    ![Markdown](//images0.cnblogs.com/blog/404392/201501/122257231047591.jpg)
    

    Markdown

    1.6.3 注意
    1. 导入的图片路径可以使用绝对路径也可以使用相对路径,建议使用相对路径。
    2. 我通常的做法是Markdown文档的同级目录下建立一个pictures文件夹,里面放置所有所需的图片,如果图片多的话,你也可以在pictures文件夹里建立子文件夹归类。

    1.7 列表

    1.7.1 说明

    使用1. 2. 3. 表示有序列表,使用* - + 表示无序列表。

    1.7.2 示例

    例1:有序列表

    1. 第一点
    2. 第二点
    4. 第三点
    
    1. 第一点
    2. 第二点
    3. 第三点

    例2:无序列表

    + 呵呵
        * 嘉嘉
        - 嘻嘻
        - 吼吼
            - 嘎嘎
            + 桀桀
    * 哈哈
    
    • 呵呵
      • 嘉嘉
      • 嘻嘻
      • 吼吼
        • 嘎嘎
        • 桀桀
    • 哈哈
    1.7.3 注意
    1. 无序列表或有序列表标记和后面的文字之间要有一个空格隔开。
    2. 有序列表标记不是按照你写的数字进行显示的,而是根据当前有序列表标记所在位置显示的,如示例1所示。
    3. 无序列表的项目符号是按照实心圆、空心圆、实心方格的层级关系递进的,如例2所示。通常情况下,同一层级使用同一种标记表示,便于自己查看和管理。
    4. 无序列表和有序列表标记的使用场景也很明了,故不多说。

    1.8 粗体和斜体

    1.8.1 说明

    使用 ** 或者 __ 表示粗体。
    使用 * 或者 _ 表示斜体。

    1.8.2 示例
     **粗体1**    __粗体2__
     *斜体1*    _斜体2_
    

    粗体1 粗体2
    斜体1 斜体2

    1.8.3 注意
    1. 前后的 *_ 与要加粗或倾斜的字体之间不能有空格。
    2. 我通常在强调时使用加粗标记,在和一行中的加粗区分且也表示强调时使用倾斜标记,这里的倾斜标记的使用场景不明确。如果你知道:请务必告诉我。

    1.9 表格

    1.9.1 说明

    具体使用方式请看示例。

    • ------:为右对齐。
    • :------为左对齐。
    • :------:为居中对齐。
    • -------为使用默认居中对齐。
    1.9.2 示例
    |         序号    |    交易名    |    交易说明    |    备注    |
    |    ------: |    :-------:    |    :---------   |    ------    |
    |    1    |    prfcfg    |    菜单配置    |    可以通过此交易查询到所有交易码和菜单的对应关系    |
    |    2    |    gentmo    |    编译所有交易    |    |
    |    100000    |    sysdba    |    数据库表模型汇总    |    |
    
    序号 交易名 交易说明 备注
    1 prfcfg 菜单配置 可以通过此交易查询到所有交易码和菜单的对应关系
    2 gentmo 编译所有交易
    100000 sysdba 数据库表模型汇总
    1.9.3 注意
    1. 每个Markdown解析器都不一样,可能左右居中对齐方式的表示方式不一样。

    1.10 分割线

    1.10.1 说明

    使用---或者***或者* * *表示水平分割线。

    1.10.2 示例
    
    ---
    
    ***
    
    * * *
    



    1.10.3 注意
    1. 只要*或者-大于等于三个就可组成一条平行线。
    2. 使用---作为水平分割线时,要在它的前后都空一行,防止---被当成标题标记的表示方式。

    1.11 链接

    1.11.1 说明

    使用[](link "Optional title")表示行内链接。其中:

    • []内的内容为要添加链接的文字。
    • link为链接地址。
    • Optional title为显示标题。显示效果为在你将鼠标放到链接上后,会显示一个小框提示,提示的内容就是 Optional title里的内容。

    参考式链接如例所示。

    1.11.2 示例

    例1:行内链接

    这就是我们常用的地址:[Baidu](www.baidu.com "百度一下,你就知道" )
    

    这就是我们常用的地址:Baidu

    例2:参考式链接

    这就是我们常用的地址:[Baidu][1]
    
    [1]:www.baidu.com "百度一下,你就知道" 
    

    这就是我们常用的地址:Baidu

    1.11.3 注意
    1. 参考式链接和行内链接的显示效果是一样的,但是在编辑状态下的使用情况不一样。行内连接紧跟链接文字,可以在看到链接文字的同时清楚的知道链接地址,但是不便于多次重复利用。参考式链接可以重复使用,但一般都是将一些链接放在一起统一管理,如一段文字后面或文章结尾,因此在找到链接和链接文字的对应关系上有些麻烦。各有利弊了,分情况使用。
    2. 使用场景很明了,不多说。

    1.11 反斜杠

    1.11.1 说明

    使用表示反斜杠。在你不想显示Markdown标记时可以使用反斜杠。

    1.11.2 示例
    *这里不会显示斜体*
    

    *这里不会显示斜体*

    1.11.3 注意

    无。

    1.12 空格

    1.12.1 说明

    Markdown语法会忽略首行开头的空格,如果要体现出首行开头空两个的效果,可以使用全角符号下的空格,windows下使用shift+空格切换。

    1.12.2 示例

    无。

    1.12.3 注意

    无。

    2. 次常用标记

    2.1 标签分类

    2.1.1 说明

    使用标签:或者Tags:表示标签标记。

    2.1.2 示例
    标签: 数学 英语
    Tags: 数学 英语
    

    标签: 数学 英语
    Tags: 数学 英语

    2.1.3 注意
    1. 标签:或者Tags:的冒号要使用半角冒号。
    2. 基本没使用过这个标记,不过应用场景应该是归类。便于快速了解文章分类。难道可以通过某种方式来遍历到标签标记?不甚了解。如你知道:请告诉我。

    2.2 删除线

    2.2.1 说明

    使用 ~~表示删除线。

    2.2.2 示例
    ~~这是一条删除线~~
    

    这是一条删除线

    2.2.3 注意
    1. 注意 ~~ 和 要添加删除线的文字之间不能有空格。
    2. 我常使用在显示的告诉自己这行文字是要删除的。

    2.3 注脚

    2.3.1 说明

    使用 [^footer] 表示注脚。

    2.3.2 示例
    这是一个注脚测试[^footer1]。
    
    [^footer1]: 这是一个测试,用来阐释注脚。
    

    这是一个注脚测试[1]

    2.3.3 注意
    1. 我常在需要解释一个名词,或者一本书,或者一个人时使用脚注标记。

    3. 不常用标记

    3.1 实现页内跳转

    3.1.1 说明

    使用html代码实现页内跳转。在要跳转到的位置定义个锚<span id = "jump">hehe</span>,然后使用[你好](#jump)你好设置为一单击即跳转到hehe所在位置的效果。

    3.1.2 示例
    [你好](#jump)
    <span id = "jump">hehe</span>
    

    你好
    hehe

    3.1.3 注意

    无。

    4. 专项使用标记

    4.1 流程图

    以后在总结吧,现在的我完全没有使用上,没有需求就先不总结了。

    4.2 LaTeX公式

    以后在总结吧,现在的我完全没有使用上,没有需求就先不总结了。


    写在后面的话

    以上都是我学习到的,然后经过几个月的使用总结的,针对我的常用非常用分类。如果有描述的不对的地方,欢迎批评指正,共同进步。


    1. 这是一个测试,用来阐释注脚。 ↩︎

    ---------------------
    想做一只蚂蚁,在自己的岗位上兢兢业业的做着自己的事情; 想做一只蚂蚁,在一个高效的团队中,共同进步!
  • 相关阅读:
    【BZOJ2067】[Poi2004]SZN
    BZOJ4675
    [bzoj3522][bzoj4543][POI2014]HOTEL
    bzoj2969矩形粉刷
    bzoj2969矩形粉刷
    1419: Red is good
    【BZOJ2698】染色
    BZOJ5084[hashit]
    [WC2014]紫荆花之恋
    齐次常系数递推关系式
  • 原文地址:https://www.cnblogs.com/crazyant007/p/4220066.html
Copyright © 2011-2022 走看看