美文网首页技术学习笔记
学习笔记【Markdown】

学习笔记【Markdown】

作者: 旧灵魂curiosity | 来源:发表于2018-06-05 10:58 被阅读0次

    Markdown简明学习笔记


    Markdown简介

    Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。[4]这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

    John Gruber 在 2004 年创造了 Markdown 语言,在语法上有很大一部分是跟亚伦·斯沃茨(Aaron Swartz)共同合作的。这个语言的目的是希望大家使用“易于阅读、易于撰写的纯文字格式,并选择性的转换成有效的XHTML(或是HTML)”。 其中最重要的设计是可读性,也就是说这个语言应该要能直接在字面上的被阅读,而不用被一些格式化指令标记(像是RTF与HTML)。 因此,它是现行电子邮件标记格式的惯例,虽然它也借鉴了很多早期的标记语言,如:Setext、Texile、reStructuredText。 许多网站都使用 Markdown 或是其变种让用户更利于讨论。例如:GitHub、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。


    Markdown语法

    id name sex
    1 A1 B1
    2 A2 B2
    3 A3 B3

    1. 标题

    标题是每篇文章必备而且最常用的格式。

    在Markdown中,如果想将一段文字定义为标题,只需要在这段文字前面加上 #,再在 # 后加一个空格即可。还可增加二、三、四、五、六级标题,总共六级,只需要增加 # ,增加一个 # ,标题字号相应降低一级。

    2-0-标题.png

    2. 列表

    列表格式也很常用,它可以让你的文稿变得井井有条。在 Markdown 中,你只需要在文字前面加上 - 就可以了;如果你希望是有序列表,在文字前面加上 1. 2. 3. 即可。

    注:-、1.和文字之间要保留一个字符的空格。

    2-1-列表.png

    3. 引用

    记录

    如果你需要在文稿中引用一段别处的句子,那么就要用到「引用」格式。

    在引用文字前加上 > 并与文字保留一个字符的空格,即可。


    2-2引用.png

    区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > :

    This is the first level of quoting.

    This is nested blockquote.

    Back to the first level.
    引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

    这是一个标题。

    1. 这是第一行列表项。
    2. 这是第二行列表项。

    给出一些例子代码:

    return shell_exec("echo $input | $markdown_script");
    

    建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以

    这是一个普通段落:

    这是一个代码区块。
    

    4. 粗体和斜体

    Markdown 的粗体和斜体也非常简单:

    用两个 * 包含一段文本就是粗体的语法;

    用一个 * 包含一段文本就是斜体的语法

    2-3-粗体斜体.png

    5. 链接与图片

    链接:在 Markdown 中,插入链接只需要使用 显示文本 即可。

    图片:在 Markdown 中,插入图片只需要使用 [图片上传失败...(image-b99d23-1528167562947)]即可。

    注:插入图片的语法和链接的语法很像,只是前面多了一个 !

    2-4链接与图片.png

    6. 分割线

    分割线的语法只需要另起一行,连续输入三个星号 *** 即可分割两段文字内容。

    如图: 2-5-分割线.png

    7. 表格

    id name sex
    1 A1 B1
    2 A2 B2
    3 A3 B3

    注意表格横线的冒号----:,此表示是否居中。
    |---|和|:--|都表示左对齐
    |:--:|表示居中对齐
    |--"|表示右对齐

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

    当你需要在Markdown文稿中键入表格,代码如下:


    2-6表格.png

    8. 代码区块

    建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以

    这是一个普通段落:

    这是一个代码区块。
    12
    

    一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。


    9. 链接

    Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。

    不管是哪一种,链接文字都是用 [方括号] 来标记。

    要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可
    This is an example inline link.
    This link has no title attribute.

    image.png

    10. 脚注

    注脚[^6][[6]]8
    使用 [^keyword] 表示注脚。
    备注:关于注脚好像每个编辑器表示方式会有所不同。


    11.待办事宜 Todo 列表

    使用带有 [ ] 或 [x] (未完成或已完成)项的列表语法撰写一个待办事宜列表例如:

    / - []things


    12. 流程图


    支持Markdown语法的软件或网站

    • Apollo 使用Markdown格式化[8]

    • Bitbucket 提供Markdown作为编写项目README文档的其中一种标记语言。[9]

    • DIASPORA* 使用Markdown格式化用户发送的消息、评论和对话。[10]

    • Drupal 是一个Markdown插件[11],始创于2008年。截止2011年11月,已有8000个建站软件使用了该插件。

    • Ghost 使用Markdown的一个标准版本编辑器来格式化撰写的文章。[12]

    • GitHub 使用Markdown的一个分支版本(称为GitHub Flavored Markdown)来格式化评论、消息以及其它内容。[13][14] John Gruber has described this dialect as a "superior variant" for "situations like user-submitted comments".[15]

    • G+ Tweaks v1.1151,一个适用于 Google+Greasemonkey 用户脚本。[16]

    • Instiki uses a Markdown extension to wiki syntax. The extended syntax is called Maruku.[17]

    • Moodle 提供 Markdown 作为语法标记语言。[18]

    • Posterous 提供 Markdown 作为语法标记语言。[19]

    • Reddit 的编辑器使用了 Markdown 语法。[20]

    • Showoff 使用 Markdown 作为提交的语法。[21]

    • Squarespace 在博客界面下提供 Markdown 编辑器。[22]

    • Stack Overflow 以及其他 Stack Exchange Network 网站使用一种 Markdown 的分支作为它的文章格式化系统。[23][24]

    • Tumblr 允许在文章中使用 Markdown。[25]

    • Typecho 原生支持Markdown编辑器,实时预览. [26]

    • The WordPress plugin system utilizes a dialect of Markdown in "readme.txt" files submitted by developers, and has plugins for Markdown.[27]

    • Second Gear's Elements app for iPhone and iPad gained Markdown capability with its v2 around November of 2010.[28]

    • 图灵社区 使用markdown语法供用户写作电子书.

    • 简书 写作网站,支持 Markdown

    • 为知笔记 是一种类似 印象笔记 的笔记软件,支持使用Markdown语法编辑笔记

    • HackMD是一个支持Markdown的在线语法编辑笔记网站,可即时切换源代码与成果查看。

    • 纯纯写作 是一种支持使用Markdown语法编辑文本的轻量级文本编辑软件

    • 有道云笔记在2016年也开始支持使用markdown来记录

    • 简书也开始支持使用markdown来记录

    相关文章

      网友评论

        本文标题:学习笔记【Markdown】

        本文链接:https://www.haomeiwen.com/subject/eacpsftx.html