孰能生巧
写在前面
简洁,是普罗大众所追求的一种精神。当我在编写文档的时候,当时还是用Windows系统,用Word编写文字觉得很不简洁。而现在Markdown的出现给很多作者一个非常棒的写作工具。之前想装逼去学 Latex ,发现不如Markdown简单易懂,其中需要很多命令和代码来堆叠,而且对于 正常写作的人 来说不是一个非常好的选择。而Markdown则是一个很容易上手的工具。
后来看了一下网上的(基本就是简书吧),教程都是很专业,很系统,但是觉得不太适合初学者。里面罗列了很多知识包括HTML的代码实现和Markdown的工作原理。我是一个程序猿嘛,我知道初学者一般都想: 你说这么多,都不敲代码,说个鬼啊。所以我在这里我不想讲这些,我想通过举例子来让你了解Markdown的基本语法。而这些语法保证可以够你完成 99.9% 的工作。
这里有人问了怎么在简书上写Markdown,简书默认是使用“富文本”形式的编辑器,说白了就是非Markdown嘛。设置到Markdown编辑器再将你写好的内容复制到上面去就好了。参考这里设置你的简书为Markdown编辑器
目录
- 写Markdown的工具
- 基本知识
- 实践运用
- 结尾
写Markdown的工具
工欲善其事,必先利其器
作为初学者首先需要知道我们最好别用txt来写Markdown,承认有些人为了装逼会用txt来写代码...我这里推荐 Atom。这里为了照顾不同操作系统的你,不要有编辑器门户之争!当然Mac下使用Macdown或者Mou也挺好。
Atom
Atom官网:点击去往Atom官网。点进去之后会看到一个大大的 Download 按钮的啦。
一步步安装,打开Atom。事实上Atom会自带Markdown的插件的,但是不知道为什么我的不行。所以得去下载一个插件:<mark>Markdown-Preview-Plus</mark>。下面是安装插件的具体步骤:
1.找到“设置”(cmd+, | win下在左上角的菜单栏就有了)
2.点进“install”,点进去输入 Markdown-Preview-plus 搜索,出现第一个点击“install”,我这边已经装了所以就没有install了,看下一个插件就有“install”了。
3.然后点进Packages里面,搜索mark,把Markdown-Preview进行disable操作。
3.拖进一个文件夹到Atom中,并在这个文件夹下面创建一个 test.md 文件,md就是Markdown缩写嘛。注意:一定要有后缀名哦~。
4.打开这个Markdown文件,试试在里面输入一些文字啥的。哎,感觉没反应是不是?现在Cmd+Shift+p(Win下Ctrl+Shift+p),在输入框中输入markdown,选择“markdown preview plus:toggle”回车就好。
然后会出出现两个屏。在第一个屏里面输入下面文字。
###### hello world
# hello world
如果产生下面效果,那么说明你完成了配置:
![Uploading test_394032.png . . .]
其实呢,我们下的Atom仅仅是个编辑器,需要一些插件来帮助我们显示markdown的预览。而我下载的那个插件就是为了预览的。事实上不下载那个插件也是可以的,建议先从第3步开始看,不知道是不是我电脑的问题我不能用Atom自带的插件。
基本语法
搞了那么久终于开始学习语法了。其实Markdown的本意就是为了简洁你的写作,所以别有太大的心里负担。后面我会给个小小例子来帮助大家一起实践。现在打开刚刚创建的test.md文件一起跟着我练习吧。
1.字体大小
输入如下
###### hello world
##### hello world
#### hello world
### hello world
## hello world
# hello world
展现效果:
hello world
hello world
hello world
hello world
hello world
hello world
注意:这里只有1~6个#号,7个就不行了,不信试试。
2.引用块
输入如下:
> 您的好友已上线
> > 黑百合报道
> > 半藏报道
> > > **这游戏还能不能玩了?** (此处有三个空格哦~否则不换行)
> > > **感觉队伍少了两个人**
展示效果
您的好友已上线
黑百合报道
半藏报道这游戏还能不能玩了?
感觉队伍少了两个人
3.强调
输入如下
**Strong** *Lean*
__Strong__ _Lean_
展现效果
Strong Lean
Strong Lean
注意:对,你没看错,两种效果一样的,选一个就行。
4.图片
首先放一张图到这个目录下,与test.dm同级的,嗯,叫test.png吧。
输入如下:
![](test.png)
![MacDown logo](http://upload-images.jianshu.io/upload_images/2979799-9e844c1c9daf991c.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
展示效果
一种本地图片,一种网上图片。格式为:![](图片路径)
。在Atom上貌似不能显示图片下标,但是在简书上面是可以的。还有,写简书的人要注意了:如果你引用本地图片写文章,在简书编辑器上面一定要将图片拖拽到简书的编辑器上面,否则本地文件简书怎么获取啊。
5.超链接
输入如下
[Baidu](http://www.baidu.com)
展示效果
这个就不用解释了吧,吧感叹号去掉就变成超链接了。
6.显示代码
输入如下
~~~java
public void hello();
~~~
```java
public void hello();
```
展示效果
public void hello();
public void hello();
没错,又是两种都行,随便挑一个。需要注意的是:可以在一开始显示需要高亮哪种语言风格,我这里就用java了,你可以试试xml,html,c都是可以的。
7.表格
输入如下
First Header | Second Header
------------- | -------------
Content Cell | Content Cell
Content Cell | Content Cell
You can align cell contents with syntax like this:
| Left Aligned | Center Aligned | Right Aligned |
|:------------- |:---------------:| -------------:|
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
展示效果
First Header | Second Header |
---|---|
Content Cell | Content Cell |
Content Cell | Content Cell |
You can align cell contents with syntax like this:
Left Aligned | Center Aligned | Right Aligned |
---|---|---|
col 3 is | some wordy text | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
看看冒号在哪,就往哪对其。
8.分割线
输入如下
---
展示效果
3个短横线就够了,你写100个也是可以的。
9.分点
输入如下
1. One
2. Two
3. Three
展示效果
- One
- Two
- Three
注意在小数点的后面需要一个空格哦
实践运用
学了一点点知识,想记住他就多打打字就能记住了。所以我提供两个.md文件给大家练习,大家可以看看里面的内容,照着内容写一下,多练练。第一个是我写的一个Spring的基本笔记,第二个是MacDown官网上的Markdown帮助手册。
结尾
是不是觉得知识都很少?没错,就是很少的,这些基本知识可以应付99.9%的写作了。如果要更多(其实也没多少)技巧,可以参考Macdown参考手册(实践运用的第二个链接,虽然是英文版的,但是你看效果就知道发生了什么)。
当然了,如果知道怎么写Html代码的同学,也是可以往这Markdown文件里面标签的,例如:<mark>嘿嘿嘿</mark>
就变成<mark>嘿嘿嘿</mark>`。
还有一些换行规则的,例如直接换行是换不了行的。可以试试空格空格空格+换行
来进行软换行,而换行+换行
则是硬换行。通俗点就是文章换行时候是不是会多出一个大空白的地方。
好了,到最后希望大家可以一起进步吧,多巧文字,慢慢学会Markdown。
\^O^/