Markdown小册子

2018-12-03 0 条评论 1.7k 次阅读 0 人点赞

经过系统的学习H5知识后,在得到技能的同时,我越来越喜欢上使用MD写东西了,之前一直用的富文本编辑器写,但自从接触到MD神器后,就再也离不开了,不管现在学什么或者写什么,都会打开VS code建立一个MD来做笔记,这里的话,我就写一下MD的基础知识,方便我自己后期查阅

二、markdown使用说明

Markdown 是一种方便记忆、书写的纯文本标记语言,用户可以使用这些标记符号以最小的输入代价生成极富表现力的文档

1.段落和换行

    • 每段之间要有一个空行才能换行
  • 或者输入一个 < br > 标签在需要换行的位置

2.标题

    • 在标题前面使用#,#个数越多级别越低
  • 可以在标题左右两侧都加上#,仅仅是为了美观

3.区块引用

    • 在段落前使用>标记就可以实现类似引用的效果
  • 区块是可以嵌套的,如下代码:
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

效果就是:

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");

效果如下:

这是一个标题。

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

给出一些例子代码:

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

4.列表

    • 无序列表使用星号(*)加号(+)或减号(-)作为列表标记
    • 有序列表则使用数字接着一个英文句点
  • 如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符

5.分隔线

  • 在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。也可以在星号或是减号中间插入空格。

6.链接

    • Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
    • 不管是哪一种,链接文字都是用 [方括号] 来标记。
  • 要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可
This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

效果如下:
This is an example inline link.

This link has no title attribute.

  • 参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:
This is [an example][id] reference-style link.

你也可以选择性地在两个方括号中间加上一个空格:

This is [an example] [id] reference-style link.

接着,在文件的任意处,你可以把这个标记的链接内容定义出来:

[id]: http://example.com/  "Optional Title Here"
  • 链接内容定义的形式为:

方括号(前面可以选择性地加上至多三个空格来缩进),里面输入链接文字
接着一个冒号
接着一个以上的空格或制表符
接着链接的网址
选择性地接着 title 内容,可以用单引号、双引号或是括弧包着

  • 下面这三种链接的定义都是相同:
[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

7.加粗强调

Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 < em > 标签包围,用两个 * 或 _ 包起来的话,则会被转成 < strong >

8.代码

  • 如果要标记一小段行内代码,你可以用反引号把它包起来(`),例如:
Use the `printf()` function.

效果如下:
Use the printf() function.

  • 若使用```包裹代码那他就会被作为代码块独立出来

9.反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

萌芽创想

这个人太懒什么东西都没留下

文章评论(0)