markdown-syntax

  • 白小霁
  • 10 Minutes
  • March 11, 2017

Markdown

优秀作品的秘籍就是:非常严格的品味,再加上实现这种品味的能力。
———《黑客与画家》

优点

语法

勤奋的男人运气都不会太差!

标题

1
2
3
4
5
6
7
8
最高阶标题(h1)
===========
第二阶标题(h2)
----------
# 一级标题
## 二级标题
....
###### 六级标题

注: #和文本之间建议留出一个空格。

演示:

最高阶标题(自己找像谁)

第二阶标题 (自己找像谁)

H1

H2

H3

….

H6

列表

1
2
3
4
+ 第一钟
- 第二种
* 第三种
1. 第四种

注: 符号与文本之间要留出一个空格。(ps:这里没有建议噢)

演示

  1. 第一种
    • 好多
    • 好多
    • 好多
  2. 第二种
    • 好多
    • 好多
    • 好多
  3. 第三种
    • 好多
    • 好多
    • 好多

超链接

1
2
3
4
5
[文本](URL "title") //(行内式)
[文本][idName] //(参考式)要配合下面一种使用
[idName]: url "title" //(可在文档的任意位置)
[idName]: url 'title' //(可在文档的任意位置)
[idName]: url (title) //(可在文档的任意位置)

演示:

白小霁

This my GitHub link 这种写法好像有正交原则,让其分离开来(ps:需源码)

图片

1
2
![Alt text](URL "title")
<img src="url" width height> //可以更改大小

演示:
路飞

注: Markdown中的图片还可以设置高宽,目前只在leanote上测试过。

引用

1
> 文本内容

演示:

你要保守你心,胜过保守一切,因为一生的果效,是由心发出。 「箴言4:23」

注: >与文本之间要留出一个空格,本人不喜欢Mahua上的引用格式,偏好Leanote上的引用格式。

###分割线

1
2
***
---

演示:




注: 要有三个以上符号组成的,中间可以有空格。

代码

1
2
3
\```代码类型
代码
``\`

演示:

1
2
3
4
5
6
7
8
9
10
<!DOCTYPY HTML>
<html>
<head>
<meta charset="UTF-8">
<title>多实践,多看书</title>
</head>
<body>
戒骄戒躁,不懂先思考,再google,再咨询前辈
</body>
</html>

强调

1
2
**文本** //加粗
*文本* //斜体

演示:
文本 文本

其他

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em> 标签),你可以在星号的前面加上反斜杠:

1
\*literal asterisks\*

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

1
2
3
4
5
6
7
8
9
10
11
12
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号

个人见解:

Q: 为什么能轻松转化为HTML格式?

A:有很多是HTML标签用特定的符号来简化表示,但Markdown在解读的时候会补充完全代码格式,仿佛像语法糖

Q: 为什么可以专注文字而不是排版?

A:最近,患上浏览页面时会用余光去瞟滚动条的习惯。当然现在的网页越来越炫酷了,从网页中摄取有用的知识,受干扰的因素也增多了不少。Markdown没有word那样需要之后更改很多的样式,在编写的时候就能设置好了。甚至希望没有计算机二级,就因为他让我裸考差两分。

参考文献

简书

Markdown语法(中文版)

Markdown: Syntax(英文版)强烈推荐