Markdown的一些心得(适合初学者)

孰能生巧

写在前面

简洁,是普罗大众所追求的一种精神。当我在编写文档的时候,当时还是用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 按钮的啦。

大大的Download

一步步安装,打开Atom。事实上Atom会自带Markdown的插件的,但是不知道为什么我的不行。所以得去下载一个插件:<mark>Markdown-Preview-Plus</mark>。下面是安装插件的具体步骤:

1.找到“设置”(cmd+, | win下在左上角的菜单栏就有了)

找到“设置”

2.点进“install”,点进去输入 Markdown-Preview-plus 搜索,出现第一个点击“install”,我这边已经装了所以就没有install了,看下一个插件就有“install”了。

安装Markdown-Preview-plus插件

3.然后点进Packages里面,搜索mark,把Markdown-Preview进行disable操作。

disable.png

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)

展示效果

Test图片滴
MacDown logo

一种本地图片,一种网上图片。格式为:![](图片路径)。在Atom上貌似不能显示图片下标,但是在简书上面是可以的。还有,写简书的人要注意了:如果你引用本地图片写文章,在简书编辑器上面一定要将图片拖拽到简书的编辑器上面,否则本地文件简书怎么获取啊。

5.超链接

输入如下

[Baidu](http://www.baidu.com)

展示效果

Baidu

这个就不用解释了吧,吧感叹号去掉就变成超链接了。

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

展示效果

  1. One
  2. Two
  3. Three

注意在小数点的后面需要一个空格哦

实践运用

学了一点点知识,想记住他就多打打字就能记住了。所以我提供两个.md文件给大家练习,大家可以看看里面的内容,照着内容写一下,多练练。第一个是我写的一个Spring的基本笔记,第二个是MacDown官网上的Markdown帮助手册。

参考实例:Spring的基本笔记

参考实例:Macdown参考手册

结尾

是不是觉得知识都很少?没错,就是很少的,这些基本知识可以应付99.9%的写作了。如果要更多(其实也没多少)技巧,可以参考Macdown参考手册(实践运用的第二个链接,虽然是英文版的,但是你看效果就知道发生了什么)。

当然了,如果知道怎么写Html代码的同学,也是可以往这Markdown文件里面标签的,例如:<mark>嘿嘿嘿</mark>就变成<mark>嘿嘿嘿</mark>`

还有一些换行规则的,例如直接换行是换不了行的。可以试试空格空格空格+换行来进行软换行,而换行+换行则是硬换行。通俗点就是文章换行时候是不是会多出一个大空白的地方

好了,到最后希望大家可以一起进步吧,多巧文字,慢慢学会Markdown。

\^O^/

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容

  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,016评论 4 62
  • 单主模式Keepalive之Nginx 调度 实验目的: 实现Nginx调度的高可用,当一台Nginx调度器故障时...
    芷_念阅读 722评论 0 7
  • 每天来到简书码字的时间,也是我和自己对话的时间。 今天早上在看书的时候,看着看着心中升起了喜悦。书上说,你先要懂得...
    小easy阅读 231评论 3 0
  • 近来,关于出轨的丑闻是一浪盖一浪,以至于吃瓜群众对“出轨”这两个字已渐渐麻木,甚至于对婚姻开始恐惧,其实没必要拿别...
    小蛮婆颜究社阅读 1,249评论 6 12