Markdown 学习笔记·入门


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个空格即表示代码块
    C#:

    //这里显示一些代码,在正文显示中会自动识别语言,进行代码染色,这是一段C#代码
    public class Blog
    {
         public int Id { get; set; }
         public string Subject { get; set; }
    }

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

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,968评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,601评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,220评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,416评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,425评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,144评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,432评论 3 401
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,088评论 0 261
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,586评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,028评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,137评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,783评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,343评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,333评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,559评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,595评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,901评论 2 345

推荐阅读更多精彩内容

  • 为什么学习Markdown 自从搭建了 Hexo 博客之后,发现还有 Markdown 这种写文章的方法,想到以后...
    lifeColder阅读 20,131评论 10 217
  • Markdown 语法 以下是 Markdown 的常用语法!在以后的笔记中将持续使用 Markdown 语法进行...
    WinSolstice阅读 1,444评论 0 1
  • 去年中秋未折花,以为花随余香去。 忽见桂子压枝低,秋花春实惟一树。 2017年4月10日江边手机摄
    远晓阅读 315评论 0 3
  • 我爱你!
    a0e7cb82012e阅读 113评论 0 1