什么是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)
效果:
跟链接的使用相同,只是前面多一个
!
号
代码
代码块:用三个反引号引起来``` ```
```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|
A | B | C |
---|---|---|
A1 | B1 | C1 |
A2 | B2 | C2 |
左对齐 | 剧中 | 右对齐 |
---|---|---|
A1 | B1 | C1 |
A2 | B2 | C2 |
问题与思考
-
链接问题
经过试验发现,链接的另一种简写方式(如下示例),在简书中无效,但在dillinger中有效。
<janshu.com>
简书中:
<jianshu.com>
dillinger中:
所以在简书中还是使用完整的写法吧
-
思考:什么时候应该使用行内代码(下面是一些个人见解)
- 对于文章中用到的有标记意义的特殊符号
- 个人觉得是文章中的特殊符号和markdown标记语言可能会产生歧义,比如文章中有
#
*
等有语法意义的符号。
- 个人觉得是文章中的特殊符号和markdown标记语言可能会产生歧义,比如文章中有
- 对于一些html标签
- 因为标签有左右尖括号,也属于html语言, 所以还是用行内代码包裹起来比较好。
- 对于html中的转义字符
- 因为markdown会自动转义如果直接写入
<
,显示的不是它本身而是左尖括号<
- 因为markdown会自动转义如果直接写入
- 对于文件名或特殊意义的名词或指令
- 例如
instruction.txt
npm install
等 ,这样可以使文章内容结构清晰
- 例如
参考链接:markdown的正确使用方式
Introduction Markdown
Online MarkDown
简书当前Markdown语法效果
-
这个就是注脚内容,写在文章最后 ↩