markdown学习笔记1.0

2018-06-15  本文已影响23人  Charrui

概述

1、兼容HTML

HTML是一种发布的格式,Markdown是一种发布的格式。Markdown 语法在 HTML 区段标签间是有效的。

Markdown 的生成器有足够智能,不会在 HTML 区块标签外加上不必要的

标签。

例:
这是一个普通段落。

<table>

<tr>

<td>1</td>

</tr>

</table>

这是另一个普通段落。

1.1表格


(作者:热心市民123
链接:https://www.jianshu.com/p/59aaa82ae723
來源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。)


表格前一定要空一行
在每个单元格文字的两端加上一个竖线“|”。
第二行控制单元格文本的位置,第二行控制文本的位置,规则如下:默认是靠左,用英文冒号“:”来调整,两边都有冒号,而且冒号中间至少有一个减号“-”的时候表示居中(当然也可以通过增加“-”号的数目来使它们对齐,更好看一点,但效果是一样的);冒号在右边而且冒号之前至少有一个-的时候表示靠右,其它情况则是靠左。注意,冒号“:”一定要为英文的,不可为中文的冒号。如:

第一季度 第二季度 第三季度 第四季度
20% 30% 25% 40%

2、特殊字符自动转换

在 HTML 文件中,有两个字符需要特殊处理: < 和 & 。 < 符号用于起始标签,& 符号则用于标记 HTML 实体,如果你只是想要显示这些字符的原型,你必须要使用实体的形式,像是 &lt和 &amp。

注意:code 范围内,不论是行内还是区块, < 和 & 两个符号都一定会被转换成 HTML 实体,这项特性让你可以很容易地用 Markdown 写 HTML code ;而HTML 语法中,要把所有的 < 和 & 都转换为 HTML 实体,才能在 HTML 文件里面写出 HTML code。

二、区块元素

1.段落和段行

2.标题

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。

类 Setext :是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)

例:This is an H1

=============

This is an H2


类 atx :在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶

例:
这是 H1 #

这是 H2 ##

这是 H3 ######

3.区块引用

在每行的最前面加上 > ;在整个段落的第一行最前面加上 > ;区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > ;引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等;

例:

这是一个标题。

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

给出一些例子代码:

return shell_exec("echo input |markdown_script");

4.列表

无序列表:使用星号、加号或是减号作为列表标记

有序列表:使用数字接着一个英文句点(数字的正确性不用在意)

例:

注意:列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:;列表要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符

5.代码区块

缩进 4 个空格或是 1 个制表符;一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。

6.分割线

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






三、区段元素

1.链接

链接文字都是用 [方括号] 来标记。

链接内容定义的形式为:

方括号(前面可以选择性地加上至多三个空格来缩进),里面输入链接文字

接着一个冒号

接着一个以上的空格或制表符

接着链接的网址

选择性地接着 title 内容,可以用单引号、双引号或是括弧包着

2.强调

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

例:

single asterisks

single underscores

double asterisks

double underscores

会转成:

single asterisks

single underscores

double asterisks

double underscores

注意:*和_两边不能都有空白,否则会被当作普通符号

3.代码

标记一小段行内代码,可以用反引号把它包起来(`)

4.图片

行内式:

[图片上传失败...(image-94cbbd-1535548389219)]

[图片上传失败...(image-4ccdee-1535548389219)]

详细叙述如下:

一个惊叹号 !

接着一个方括号,里面放上图片的替代文字

接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。

参考式:

Alt textAlt text

「id」是图片参考的名称,图片参考的定义方式则和连结参考一样:

四、补充

1.反斜杠

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

\ 反斜线

` 反引号

_ 底线

{} 花括号

[] 方括号

() 括弧

井字号

. 英文句点

! 惊叹号

2.自动链接

支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。

五、Markdown 免费编辑器

1.Windows 平台

Markdownpad

Markpad

2.Linux 平台

Retext

Mac 平台

Mou

3.在线编辑器

Markable.in

Dillinger.io

4.浏览器插件

MaDe(Chrome)

上一篇下一篇

猜你喜欢

热点阅读