热门IT资讯网

markdown 入门

发表于:2024-11-24 作者:热门IT资讯网编辑
编辑最后更新 2024年11月24日,# markdown quickstart---[TOC]---## 1.introductionmarkdown的最初设计是让人专注写作,又让输出内容易于阅读。它适用于典型应用场景,如写博客,说明文

# markdown quickstart
---
[TOC]

---

## 1.introduction
markdown的最初设计是让人专注写作,又让输出内容易于阅读。它适用于典型应用场景,如写博客,说明文档等一切要求书写内容大且快速形成易于阅读的文档。

对比HTML,wiki, Markdown是一种轻量级的标记语言,语法简单,可以排出简洁的表现界面,适用于网络的书写语言,且支持表格,代码块,目录,链接等


###markdown优点
- 纯文本
- 快速格式化
- 书写简单,易学易懂,且源码易阅读
- 利用导出其它流行格式html,pdf等
- 扩展工具免费且丰富

###markdown缺点
- 不支持更丰富的格式化
- 未标准化

##2.markdown 快速入门语法

###1. heading
```
#h2


##h3


###h4


```

###2. bold,Italic & strikethrough
*Italic*
**bold**
***bold&Italic***
~~删除线~~

###3. list
也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符
列表支持嵌套

- unorder list1
- unorder list2
- unorder list3
* unorder list4
* unorder list5
+ unorder list6



1. order list 1
2. order list 2
3. order list 3

###5. table
header1 | header2 | header3
--- |-------: |:---:
foo | foo | foo
bar | bar | bar
baz | baz | baz

| Tables | Are | Cool |
| :-------------: |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |


### 6. todo list
- [] todo1
- [x] todo2
- [x] todo3


###7. blockquote

```

it can be used to highlight your code
使用多个>,可以将
嵌套,且
内可以使用其它markdown语法
line 1
line 2
line 3
```


> This is the first level of quoting.
>
> `inline code`
> `sum = b + c` inline code 行内代码
> `mkdir tickets` then ` cd tickets`
> header line test
>
> - unorder list1
> - unorder list2
> > This is nested blockquote. 引用嵌套
>
> Back to the first level.

###8. other
--- 分页线


空白行表示另起一个段落




行尾两个以上空格+Enter
markdown段内强制换行

###9.兼容HTML
1. 不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写
2. 一些HTML的区块元素,如`

`等标签,必须在前后加上空行与其它内容区隔开
3. HTML的开始标签与结尾标签不能用制表符或空格来缩进
4. 在 HTML 区块标签间的 Markdown 格式语法将不会被处理
5. HTML 的区段(行内)标签如 ` `可以在 Markdown 的段落、列表或是标题里随意使用

Here is an example of AppleScript:



###10.特殊字符自动转换< & \
HTML中的两个字符(< &)需要特别处理,<用于标签,&用于标记HTML实体。 markdown可以让人自然地书写字符,它会根据语境自动决定是否转换:
markdown code 范围内,无论是行内还是区块,< 和 & 都一定会被转换成 HTML 实体
markdown使用\来转义,表示文本中markdown符号




## markdown editor
[Mahua](http://mahua.jser.me/)
[maxiang](https://maxiang.io/)
[mou](http://25.io/mou/)
[gedit-markdown](https://github.com/jpfleury/gedit-markdown)
[markdown 语法说明](http://wowubuntu.com/markdown/index.html#autoescape)


0