Skip to content

Commit 24b28e9

Browse files
committed
初步提交markdown语法教程
0 parents  commit 24b28e9

19 files changed

+853
-0
lines changed

.gitignore

+65
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# OS generated files #
2+
######################
3+
.DS_Store
4+
.DS_Store?
5+
._*
6+
.Spotlight-V100
7+
.Trashes
8+
Icon?
9+
ehthumbs.db
10+
Thumbs.db
11+
12+
# Logs and databases #
13+
######################
14+
*.log
15+
16+
# Package Files #
17+
*.war
18+
*.ear
19+
20+
*.iml
21+
*.ipr
22+
*.iws
23+
*.swp
24+
25+
# Compiled source #
26+
###################
27+
.gradle/
28+
out/
29+
build
30+
target
31+
bin/
32+
dist/
33+
src/main/webapp/WEB-INF/classes/
34+
35+
# eclipse file #
36+
################
37+
.classpath
38+
.settings/
39+
.project
40+
.mymetadata
41+
.checkstyle
42+
43+
# idea files #
44+
################
45+
.idea/
46+
tasks.xml
47+
48+
# others
49+
src/main/resources/rebel.xml
50+
.sonar
51+
_book
52+
53+
# Node rules:
54+
## Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
55+
.grunt
56+
57+
## Dependency directory
58+
## Commenting this out is preferred by some people, see
59+
## https://docs.npmjs.com/misc/faq#should-i-check-my-node_modules-folder-into-git
60+
node_modules
61+
62+
# eBook build output
63+
*.epub
64+
*.mobi
65+
*.pdf

Editor.md

+60
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
目录
2+
3+
* [Windows](#windows)
4+
* [Mac](#mac)
5+
* [多平台](#mp)
6+
* [浏览器插件](#plugin)
7+
* [在线](#online)
8+
9+
### <a name="windows" />Windows
10+
11+
* [Miu](http://www.appinn.com/miu-markdown-editor/)
12+
一款模仿mou 的windows平台markdown编辑器,小众推荐,必属精品,官网无法打开,好在小众提供了百度云下载。界面美观,功能不够成熟
13+
![Miu](http://www.williamlong.info/upload/4319_13.jpg)
14+
15+
* [MarkdownPad](http://www.markdownpad.com/)
16+
一款全功能的编辑器,被很多人称赞为windows 平台最好用的markdown编辑器
17+
![MarkdownPad](http://www.williamlong.info/upload/4319_10.jpg)
18+
19+
* [Smark](http://git.oschina.net/elerao/Smark)
20+
开源软件
21+
![Smark](http://www.williamlong.info/upload/4319_11.jpg)
22+
23+
* [MdCharm](http://www.mdcharm.com/)
24+
功能完备;长相一般,隐藏菜单栏后也算简约。有Windows 和Linux版本。目前已开源,不再更新。
25+
![MdCharm](http://www.williamlong.info/upload/4319_12.jpg)
26+
27+
### <a name="mac" />Mac
28+
29+
* [Mou](http://25.io/mou/)
30+
预览速度快,简洁。0.8.7免费使用,最新版要付费。
31+
![Mou](http://www.williamlong.info/upload/4319_13.jpg)
32+
33+
* [Typora](http://www.typora.io/)
34+
![Typora](http://www.williamlong.info/upload/4319_15.jpg)
35+
36+
### <a name="mp" />多平台
37+
38+
* [小书匠](http://soft.xiaoshujiang.com/)
39+
全平台覆盖并且有web版
40+
![小书匠](http://www.williamlong.info/upload/4319_7.jpg)
41+
42+
### <a name="plugin" />浏览器插件
43+
44+
* Chrome
45+
* [马克飞象](https://chrome.google.com/webstore/detail/marxico/kidnkfckhbdkfgbicccmdggmpgogehop)
46+
一款专为印象笔记(Evernote)打造的Markdown编辑器,通过精心的设计与技术实现,配合印象笔记强大的存储和同步功能,带来前所未有的书写体验.
47+
![马克飞象](http://www.williamlong.info/upload/4319_4.jpg)
48+
49+
### <a name="online" />在线
50+
51+
* [Dillinger](http://dillinger.io/)
52+
漂亮强大,支持md, html, pdf 文件导出。支持dropbox, onedrive,google drive, github. 来自国外,可能不够稳定。
53+
![Dillinger](http://www.williamlong.info/upload/4319_1.jpg)
54+
55+
* [MaHua](http://mahua.jser.me/)
56+
小众软件推荐,界面有些简陋
57+
![MaHua](http://www.williamlong.info/upload/4319_2.jpg)
58+
59+
* [Cmd Markdown](https://www.zybuluo.com/mdeditor)
60+
* [小书匠](http://markdown.xiaoshujiang.com/)

Links.md

+6
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
* 中文
2+
* [Markdown 语法说明](http://wowubuntu.com/markdown/)
3+
* [好用的Markdown编辑器一览](http://www.williamlong.info/archives/4319.html)
4+
* 英文
5+
* [Markdown Cheatsheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)
6+
* [Markdown: Syntax.](http://daringfireball.net/projects/markdown/syntax)

README.md

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
Markdown教程
2+
===
3+
4+
Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。

SUMMARY.md

+17
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
* [语法](grammar/README.md)
2+
* [标题](grammar/Title.md)
3+
* [强调](grammar/Emphasis.md)
4+
* [列表](grammar/Lists.md)
5+
* [代码区块和语法高亮](grammar/Code.md)
6+
* [图片](grammar/Image.md)
7+
* [表格](grammar/Table.md)
8+
* [引用](grammar/Blockquotes.md)
9+
* [内嵌HTML](grammar/Inline-HTML.md)
10+
* [分割线](grammar/Horizontal-Rule.md)
11+
* [换行](grammar/LineBreaks.md)
12+
* 其他
13+
* [转义](other/Escape.md)
14+
* [自动链接](other/AutoLink.md)
15+
* Markdown插件
16+
* [编辑器](Editor.md)
17+
* [参考](Links.md)

book.json

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
{
2+
"plugins":["highlight"]
3+
}

grammar/Blockquotes.md

+53
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
Markdown 标记区块引用是使用类似 email 中用 `>` 的引用方式。如果你还熟悉在 email 信件中的引言部分,你就知道怎么在 Markdown 文件中建立一个区块引用,那会看起来像是你自己先断好行,然后在每行的最前面加上 `>`
2+
3+
```
4+
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
5+
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
6+
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
7+
>
8+
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
9+
> id sem consectetuer libero luctus adipiscing.
10+
```
11+
12+
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 `>`
13+
14+
```
15+
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
16+
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
17+
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
18+
19+
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
20+
id sem consectetuer libero luctus adipiscing.
21+
```
22+
23+
区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 `>`
24+
25+
```
26+
> This is the first level of quoting.
27+
>
28+
> > This is nested blockquote.
29+
>
30+
> Back to the first level.
31+
```
32+
33+
效果参考
34+
> This is the first level of quoting.
35+
>
36+
> > This is nested blockquote.
37+
>
38+
> Back to the first level.
39+
40+
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:
41+
42+
```
43+
> ## 这是一个标题。
44+
>
45+
> 1. 这是第一行列表项。
46+
> 2. 这是第二行列表项。
47+
>
48+
> 给出一些例子代码:
49+
>
50+
> return shell_exec("echo $input | $markdown_script");
51+
```
52+
53+
任何像样的文本编辑器都能轻松地建立 email 型的引用。例如在 BBEdit 中,你可以选取文字后然后从选单中选择<u>增加引用阶层</u>。

0 commit comments

Comments
 (0)