zoukankan      html  css  js  c++  java
  • Markdown使用教程

    什么是Markdown语言

    Markdown是一门如同HTML一样的标记语言。它使用一些简单的标记来展现文档的不同格式,例如,本章节的标题我们就是使用这样的格式表示的:

    # 什么是Markdown语言
    

    这个展现出来的就是本章的标题。

    为什么使用Markdown语言

    • 样式丰富
      使用Markdown语言,可以使文档拥有丰富的展现形式,各种不同的格式,十分适用于博客,文档等使用场景。
    • 简单易学
      通过上一节的例子我们会发现,Markdown语言明显比其他标记语言,如HTML,简单易学。在HTML中写标题样式是这样的:
    <h1>什么是Markdown语言</h1>
    

    可以很容易的看出比Markdown麻烦很多——Markdown只需要多一个字符就可以展示为标题,而HTML需要9个。
    另外,Markdown也比HTML易学很多。HTML的教程动辄几百页,而Markdown只要一篇简短的教程就能搞定。

    • 版本控制友好
      如果只是因为有丰富的格式样式的话,我们为什么不选择Word呢?这里有两个原因。其中之一就是版本控制友好。(另一个原因是有很多在线编辑平台支持Markdown,但并不支持Word。)
      一般的版本控制系统都是基于文件字符的,而Word使用的是一种特殊的编码格式。因此,当你使用版本控制工具比对Word文件的版本的时候,你其实能够看到的只是一堆乱码。而如果你要去对比Markdown的文档时,则可以看到非常清晰的版本对比信息。
      Markdown语言的版本对比十分清晰
    • 使用广泛
      大多数的博客系统,如简书,wordpress等;和很多技术社区及文档平台,如github,图灵社区等都支持wordpress编辑模式。学会Markdown就可以让我们在这些平台上更容易地编辑出漂亮的文档。

    在哪里实战操作

    我们学习一个语言最好的方式就是实战。那么我们学习markdown语言要去哪里实战呢?您可以在网上搜索Markdown在线编辑器,一般这种编辑器都是左边写Markdown,右边就时时把样式展现出来的,十分方便。这样您就可以边看教程,边练习了。

    语法

    换行

    Markdown中最基本的语法就是换行。在标准的Markdown中,输入一个回车是起不到换行的效果的:

    第一行
    第二行
    

    在标准的Markdown中,这样的文本显示出来的是:

    第一行 第二行
    

    如果我想换行就必须在每行的末尾加两个空格,或使用两个回车起到换行的效果(两个回车的换行在展示中也会多一行)。
    不过,很多平台,如简书,都支持一个回车直接换行。但是为了确保编写的Markdown有最好的兼容性。还是建议使用标准的Markdown语法进行换行。

    标题

    标题也是个十分常用的语法。Markdown中最多支持六级标题:

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

    一级标题

    二级标题

    三级标题

    四级标题

    五级标题
    六级标题

    需要注意的是,标准的格式是 井号+空格+标题。有些Markdown编辑器支持井号后边不加空格也可以,但那是不标准的语法。

    加粗

    加粗语法一般有两种:

    这样可以**加粗**。
    这样也可以 __加粗__ 。
    

    这样可以加粗
    这样也可以 加粗

    加粗的两种语法分别是前后加两个星号,或前后加两个下划线。需要注意的是,前后加两个下划线的写法,在标准的Markdown语法中是要前后加空格的。当然依旧有些编辑器可以省略前后的空格。

    斜体

    斜体语法一般也有两种:

    这样可以*斜体*。
    这样也可以 _斜体_ 。
    

    这样可以斜体
    这样可以 斜体

    斜体的两种语法分别是前后加一个星号,或前后加一个下划线。需要注意的是,前后加一个下划线的写法,在标准的Markdown语法中是要前后加空格的。当然依旧有些编辑器可以省略前后的空格。

    删除线

    如果我们想明确的表达,不要某句话了或不要这么做,我们可以使用删除线:

    ~~我要删掉这个。~~
    

    我要删掉这个。

    删除线的写法就是前后加两个波浪号。

    引用

    如果我们想引用一段文字我们可以这样:

    >黄鸟于飞,
    >集于灌木,
    >其鸣喈喈。
    

    黄鸟于飞,
    集于灌木,
    其鸣喈喈。

    使用引用,就是在你引用的文字前边加上小于号。

    引用代码

    引用代码分为两种模式,一种是行内引用,一种是多行引用。
    我们先来说行内引用:
    使用'public static void main()'来声明入口函数。
    使用public static void main()来声明入口函数。
    我们在要引用的代码前后都加一个撇号就可以在行内引用代码了 。
    我们再来说引用多行代码的方法:
    '''
    public static void main(){

    }
    '''

    public static void main(){
    
    }
    

    引用多行代码的方式就是在代码上下分别加三个撇号。

    列表

    列表一般有两种情况,一种是无序列表,一种是有序列表。
    使用无序列表的方法如下:

    - 列表
    - 列表
    - 列表
    
    • 列表
    • 列表
    • 列表

    无序列表的使用方式是,减号+空格+文字。空格务必不能丢掉。
    有序列表的使用只是把减号换成了数字标号:

    1. 列表
    2. 列表
    3. 列表
    
    1. 列表
    2. 列表
    3. 列表

    有序列表的语法是 编号+点+空格+文字。也许你会奇怪,这样写有什么意义呢。
    那我们换一种写法。

    1. 列表
    1. 列表
    1. 列表
    
    1. 列表
    2. 列表
    3. 列表

    你会发现,它展现的还是123。
    除了无序列表和有序列表,列表还有一个概念就是多级列表:

    - 一级列表
    一级列表内容
      - 二级列表
    二级列表内容
        - 三级列表
    三级列表内容
    
    • 一级列表
      一级列表内容
      • 二级列表
        二级列表内容
        • 三级列表
          三级列表内容

    只需要在列表前边加个tab就可以了。

    链接

    下面为大家介绍如何使用Markdown加入链接:

    这是百度的[链接](http://www.baidu.com.cn)
    

    这是百度的链接
    这是最普通的加入链接的方式,中括号内是会触发链接的文字,小括号内是链接的地址。
    还有一种页内链接,可以跳转到指定的标题:

    跳到加粗的链接:[链接](#加粗)
    

    跳到加粗的链接:链接
    只要在写链接的小括号中写上 井号+标题,即可。但是有的Markdown编辑器对页内链接功能支持并不友好,比如简书。
    当然,链接还支持相对路径链接。

    表格

    表格的写法如下:

    |表头一|表头二|表头三|
    |-|-|-|
    |内容一|内容二|内容三|
    |内容一二三|内容四五六|内容七八九|
    
    表头一 表头二 表头三
    内容一 内容二 内容三
    内容一二三 内容四五六 内容七八九

    表格也可以设置左对齐,右对齐和居中:

    |左对齐|右对齐|居中|
    |:-|-:|:-:|
    |内容一|内容二|内容三|
    |内容一二三|内容四五六|内容七八九|
    
    左对齐 右对齐 居中
    内容一 内容二 内容三
    内容一二三 内容四五六 内容七八九

    引入图片

    引入图片的方法如下:

    ![百度Logo](http://www.baidu.com/img/baidu_jgylogo3.gif)
    

    百度Logo
    叹号开头,中括号中为图片的alt,小括号中为图片的地址。

    以上就是标准Markdown语言的基本用法。Markdown在不同的平台中还有不同的功能拓展,大家可以在使用那些平台的时候再去查阅相关的帮助文档。

  • 相关阅读:
    端口
    log4j常用配置以及日志文件保存位置
    jbpm node signal
    JBPM3.2 TABLE
    JBPM TaskInstance 对象创建过程
    【转】链接脚本
    快速平方根倒数
    GPS开发之知识储备(NMEA0183)
    HEX文件格式和其校验算法
    NRF51822之IIC(MEMS_LIS2DH12)
  • 原文地址:https://www.cnblogs.com/meibaorui/p/markdown_tutorial.html
Copyright © 2011-2022 走看看