Markdown 学习笔记·入门

  花一点点时间了解了下Markdown的语法,确实非常简单,这里做下总结,也算是对Markdown语法的熟悉,及模仿造轮子吧~

markdown 简介

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。
Markdown具有一系列衍生版本,用于扩展Markdown的功能(如表格、脚注、内嵌HTML等等),这些功能原初的Markdown尚不具备,它们能让Markdown转换成更多的格式,例如LaTeX,Docbook。Markdown增强版中比较有名的有Markdown Extra、MultiMarkdown、 Maruku等。这些衍生版本要么基于工具,如Pandoc;要么基于网站,如GitHub和Wikipedia,在语法上基本兼容,但在一些语法和渲染效果上有改动。–百度百科

特点总结

  • 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
  • 让你专注于文字而不是排版。
  • 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
  • Markdown 的标记语法有极好的可读性。

Markdown 语法介绍

基本符号

  • *,-,+ 3个符号 被称为Markdown符号
  • 空白行表示另起一个段落
  • `是表示inline代码,tab是用来标记 代码段,分别对应html的code,pre标签

标题

  • # + 空格 后面的文字即表示为标题

      # 表示一级标题,## 表示二级标题,依次表示 1-6 级标题
    
  • 注意: 符号后面要加一个 空格 和文本内容隔开

  • 还可以在文字下行加= 表示大标题 - 表示小标题 慎用吧

      例如:
      大标题
      =
      小标题
      -
    

字体:斜体 / 加粗

    *文本* 表示文本内容为斜体, **文本** 表示文本内容为加粗
  • 效果: 斜体文本 加粗文本

换行

  • 段落间加一个 空白行 分割 同html中的 <p>
  • 连续两个空格即为换行 同html中的 <br>

列表

  • 使用*,+,-加上一个空格来表示

  • 可以支持嵌套,如

      *,+,-效果一样的
      - 外层列表项目
            + 内层列表项目
           + 内层无序列表项目
          + 内层列表项目
      - 外层列表项目
    
  • 效果


  • 外层列表项目
    • 内层列表项目
    • 内层列表项目
    • 内层列表项目
  • 外层列表项目

  • 有序列表用 数字+英文点+空格来表示

      - 1. 这样会展示序号 
    
  • 效果:

    1. 这样会展示序号
  • 注意:列表内容很长的,不需要手工输入换行符,css控制段落的宽度,会自动的缩放的

链接

  • 这其实是我第一个接触的markdown语法,第一篇资料收集时就用到了

       直接使用 [文本](链接)
    
  • 效果:百度

       如果很多地方需要相同的url呢,可以预先定义url 这样玩:[ref_name]:URL  
       ref_name 一般使用数字表示,显得专业 然后在需要使用链接的地方 使用[文本][ref_name] 这种方式即可,酷炫
    
  • 效果
    [1]:https://www.baidu.com/

        [ref_name]:url 如: [1]:https://www.baidu.com/ 
    
  • 引用上面定义的url [百度][1]

  • 如果想把URL展示出来,并可以作为链接使用 这样玩:<URL>

        <url> 如: <https://www.baidu.com/> 
    
  • 效果:https://www.baidu.com/

图片

  • 图片语法与链接类似

      ![](图片地址) 如: ![](http://i.imgur.com/P7ACmyM.png)
    

  • 同样可以使用引用的方式使用图片

      这样定义:[id]:图片url  这样引用定义 ![][id]
    
  • 定义图片的大小或比例

  • 方法一:嵌入HTML代码

          <img src="./xxx.png" width = "300" height = "200" alt="图片名称" align=center /> 注意:要居中展示,外围加<div>即可
    
  • 方法二:使用支持图片大小更改操作的 Mou 编辑器 (mac可以玩)

           ![](url =100x100) 注意: =前有个空格,可以只写宽度。         
    
  • 方法三: 阿里云的OSS,七牛云的图片服务器时,url上加上相关操字段即可实现图片大小,比例修改,具体见各自的产品文档~

引用

  • 开篇关于Markdown的简介和特点就是引用的百度, 只要在第一行加上 “>”和一个空格,表示代码引用,还可以嵌套

转义

  • 使用 \ 来转义,表示文本中的markdown符号

      如: \[百度](https://www.baidu.com/)
    
  • 效果:[百度](https://www.baidu.com/)

表格

  • 表格代码

    | Tables | Are | Cool |
    | ————- |:————-:| —–:|
    | col 3 is | right-aligned | $1600 |
    | col 2 is | centered | $12 |
    | zebra stripes | are neat | $1 |

    ————- 左对齐 :————-: 居中 —–:右对齐

  • 效果:

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

代码块

  • 按下Tab键 或4个空格即表示代码块

  • 下面是一小段代码举例:

    1
    2
    3
    4
    5
    6
    //这里显示一些代码,使用```java```,进行代码染色,这是一段使用JAVA代码
    public class Blog{
    public int Id
    public string Subject
    省略 get() set() toString() ...
    }

这样基本就可以玩起来了,还是需要多实践,多谢,多总结。

我们活在各自的的心灵世界,我们有什么样的心,就决定我们看到什么样的世界