5

Markdown语法入门

 3 years ago
source link: https://nanyiniu.github.io/2020/09/03/markdown%E5%9F%BA%E6%9C%AC%E8%AF%AD%E6%B3%95/
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

Markdown语法总结

概述

其实markdown是一种标记型的语法,简洁好用,通过工具能够进行预览,不用担心格式问题,并且由很多工具支持markdown的预览。

正文

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。

在编辑的过程当中每编辑一块的内容,就要空一行,否则可能出现渲染失败,出现格式乱掉的情况。

标题

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

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

This is an H1

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

This is an H2

-------------

This is an H1

This is an H2

也能使用atx 使用 # 来进行1-6阶的划分 如:

# This is an H1

## This is an H2

This is an H1

This is an H2

区块引用

> 区块应用 使用 > 符号进行标识 。
能每行都使用 > 进行标识,也能只在第一行标识,两种效果相同。

区块应用 使用 > 符号进行标识 。
能每行都使用 > 进行标识,也能只在第一行标识,两种效果相同。

列表

  1. 无序列表 可以使用*号或者+号或者-号都是一样的
  2. 有序列表 可以使用数字加英文.加空格使用有序列表

分割线

三个以上的*就是分割线,和三个---的效果相同。一般使用---


链接

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.

下面是一个参考式链接的范例:

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”

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

强调

使用两个**或者_表示强调 使用一个*或者一个_表示斜体

如: helloworld helloworld

代码

使用`符号来使用代码块
行内代码使用`包起来 如 print()

可以使用三个`+语言名称 来标注是哪种语言,能够使用特定的语法高亮(前提是编辑器支持)

图片

同样的图片也有行内式和参考式
向链接一样只不过在前面多个 !

其他

大部分markdown编辑工具支持html语法,如常用的 <mark></mark> 使用起来效果就是这样.

同样加粗等语法可以使用对应的标签<b></b>

工具推荐

  • windows、mac、linux上推荐 typero,可以实现编辑时预览,所见即所得。
  • 其中mac还可以使用macdown工具,简洁好用。

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK