千家信息网

前端学Markdown

发表于:2024-11-25 作者:千家信息网编辑
千家信息网最后更新 2024年11月25日,概述Markdown的目标是实现易读易写,一份使用Markdown格式撰写的文件应该可以直接以纯文本发布Markdown的语法全由一些符号所组成,它的语法种类很少,只对应HTML标记的一小部分。由于M
千家信息网最后更新 2024年11月25日前端学Markdown

概述

Markdown的目标是实现易读易写,一份使用Markdown格式撰写的文件应该可以直接以纯文本发布

Markdown的语法全由一些符号所组成,它的语法种类很少,只对应HTML标记的一小部分。由于Markdown实际上就是简化版的HTML,所以直接写HTML也是可以的

段落

不加任何符号的一段字符,就是一个段落。多个段落之间用空行分隔
[注意]在markdown中,多个空行会合并为一个空行显示

p1   p2p3

输出HTML为

p1

p2

p3

换行

如果段落之间没有空行,则解析为HTML标签

p1p2p3

输出HTML为

p1
p2
p3

标题

#、##、###、####、#####、######分别对应

。其实我个人感觉,不如直接使用标签方便,特别是到标题3以后

#h2##h3###h4####h5#####h6######h7

输出HTML为

h2

h3

h4

h5
h6
h7

区块

说起区块,可能听说的人比较少。它用'>'这个符号来表示,对应于HTML中的

标签,用于引用块元素。《Head first HTML And CSS》一书中,还专门针对
进行了详细的区分,但实际用的比较少
但是,markdown对应区块引用的实现上,并不能完整表达
标签的语义,应该可以引用多个段落,但实际上markdown的'>'符号只能引用一个段落

>p1p2

输出HTML为

p1

p2

列表

【无序列表】

无序列表使用星号、加号和减号来做为列表的项目标记

* red* blue* green+ red+ blue+ green- red- blue- green

输出HTML为

  • red
  • blue
  • green

【有序列表】

有序的列表则是使用一般的数字接着一个英文句点作为项目标记

1. Red2. Green3. Blue

输出HTML为

  1. red
  2. blue
  3. green

[注意]如果在项目之间插入空行,那项目的内容会用

包起来

分隔线

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

* * *********- - ----------------------------------------

输出HTML为






链接

Markdown支持三种形式的链接语法:行内、参考和自动。行内和参考链接都使用角括号把文字转成链接

[注意]由于Markdown默认产生的链接是当前页打开,且无法实现_blank,所以,就个人而言还是直接使用更方便

【行内链接】

行内形式是直接在后面用括号直接接上链接

This is an [example link](http://cnblogs.com/)

输出HTML为

This is anexample link

【参考链接】

参考形式的链接可以为链接定一个名称,之后可以在文件的其他地方定义该链接的内容。title属性是选择性的,链接名称可以用字母、数字和空格,但是不分大小写

I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].[1]: http://google.com/ "Google"[2]: http://search.yahoo.com/ "Yahoo Search"[3]: http://search.msn.com/ "MSN Search"

输出HTML为

I get 10 times more traffic from Google than from Yahoo or MSN.

【直接链接】

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

[注意]在网址前一定要加http://,否则将不会被识别为URL

输出HTML为

http://cnblogs.com/

图片

图片的语法和链接很像。先是一个惊叹号!,接着一个方括号,里面放上图片的替代文字,接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的'title'文字

【行内形式】

![alt text](/path/to/img.jpg "Title")

【参考形式】

![alt text][id][id]: /path/to/img.jpg "Title"

上面两种方法都会输出HTML为:

alt text

代码

【code】

使用反引号`来标记代码区段,区段内的&、<和>都会被自动的转换成HTML实体

`

`段落`

`

输出HTML为

段落

【pre】

如果要建立一个已经格式化好的代码区块,只要每行都缩进 4 个空格或是一个 tab 就可以了,而 &、< 和 > 也一样会自动转成 HTML 实体

For example.

输出HTML为

<blockquote><p>For example.</p></blockquote>

强调

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

如果* 和 _ 两边都有空白的话,它们就只会被当成普通的符号。如果要在文字前后直接插入普通的星号或底线,可以用反斜线:

\*em* **strong*\*

输出HTML为

emstrong

转义

在markdown中,有一些符号具有特殊的用途,如\、*等,如果要使用它们的本意,则需要在前面加一个反斜杠\来实现

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

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

空两格

使用markdown排版时,很常用的需求是实现首行缩进,一般使用两个全角空格&emsp$emsp来实现

注意

在博客园中使用markdown写博客时,由于没有即时显示的功能,经常因为多敲了几个空格,而被解析为
的情况


0