什么是Markdown

Markdown是一个文本到HTML(text-to-HTML)的转换工具， 最初由John Gruber用Perl编写，在2004年基于BSD许可发布 （摘抄自Markdown）

为什么使用Markdown

易学，易用，快捷，有效， 逻辑清晰。

简单使用Markdown

标题

示例：

# title 1
## title 2
### title 3
#### title 4
##### title 5
###### title 6

效果：

title 1

title 2

title 3

title 4

title 5

title 6

记得 # 越多字体越小~

列表

示例：

无序列表
  - menu1
  - menu2
    * menu 2.1
    * menu 2.2
      + menu 2.2.1
      + menu 2.2.2
有序列表
一. menu1
二. menu2
三. menu3

效果：

• menu1
• menu2
  • menu 2.1
  • menu 2.2
    • menu 2.2.1
    • menu 2.2.2

一. menu1
二. menu2
三. menu3

引用

示例：

>markdown是一种轻量级标记语言

效果

markdown是一种轻量级标记语言

链接

示例：

[简书](http://www.jianshu.com/ "简书")

效果：
简书

其中[]内是链接名称,()内的是第一个参数是链接地址，第二个参数是html<a>标签的title属性
如果要给文章中许多词上加链接，排版会看起来比较杂乱还可以采用另一种方式，请看下面这段文字：

我们用[谷歌][google]搜索， 在[github][github]上上传代码， 在[简书][jianshu]上发表学习笔记，在[卓越女生论坛][exc-girls]上面讨论问题。
[google]: https://www.google.com.hk/
[github]: https://github.com/
[jianshu]: http://www.jianshu.com/
[exc-girls]: https://bbs.excellence-girls.org/

效果：
我们用[谷歌][google]搜索， 在[github][github]上上传代码，在[简书][jianshu]上发表学习笔记，在[卓越女生论坛][exe-girls]上讨论问题。
[google]: https://www.google.com.hk/
[github]: https://github.com/
[jianshu]: http://www.jianshu.com/
[exe-girls]: https://bbs.excellence-girls.org/

其实就是用一个id先将链接词汇标记起来，然后再统一写链接地址。

图片

示例：

![N|Solid](https://cldup.com/dTxpPi9lDf.thumb.png)

效果：

N|Solid

代码

代码块：用三个反引号引起来``` ```
```javacript
function sayHello(){
alert("hello world");
}
```
效果：

function sayHello(){
    alert("hello world");
}

行内代码：用单个反引号引起来``

在什么情况下使用`inline-code`呢

效果：
在什么情况下使用inline-code呢

强调

示例：

**加粗**
*倾斜*

效果：
加粗
倾斜

脚注

示例：

脚注[^fn1]
...
文章底部：
[^fn]:这个就是注脚内容，写在文章最后

效果：
脚注^[1]

表格

示例：

普通表格：
|A|B|C|
|-|-|-|
|A1|B1|C1|
|A2|B2|C2|
对其方式：
|左对齐|剧中|右对齐|
|:-|:-:|-:|
|A1|B1|C1|
|A2|B2|C2|

问题与思考

1. 链接问题

经过试验发现，链接的另一种简写方式（如下示例），在简书中无效，但在dillinger中有效。

<janshu.com>

简书中：
<jianshu.com>
dillinger中：

图一

所以在简书中还是使用完整的写法吧

2. 思考：什么时候应该使用行内代码（下面是一些个人见解）

• 对于文章中用到的有标记意义的特殊符号
  • 个人觉得是文章中的特殊符号和markdown标记语言可能会产生歧义，比如文章中有 # *等有语法意义的符号。
• 对于一些html标签
  • 因为标签有左右尖括号，也属于html语言， 所以还是用行内代码包裹起来比较好。
• 对于html中的转义字符
  • 因为markdown会自动转义如果直接写入<,显示的不是它本身而是左尖括号<
• 对于文件名或特殊意义的名词或指令
  • 例如instruction.txt npm install 等 ,这样可以使文章内容结构清晰

参考链接：markdown的正确使用方式
Introduction Markdown
Online MarkDown
简书当前Markdown语法效果

1. 这个就是注脚内容，写在文章最后 ↩