[02]简书markdown教程

1 支持 Markdown 的编辑器

Windows

推荐 Sublime Text 3&＃xff0c;强大优雅的编辑器。
MarkdownPad&＃xff0c;一款可以直接预览排版效果的编辑器。

Mac

推荐 Ulysess&＃xff0c;专注写作的编辑器&＃xff0c;功能强大&＃xff0c;体验一流。
Macdown&＃xff0c;可以预览排版效果。

Linux

推荐 VIM&＃xff0c;编辑器之神。当然&＃xff0c;Emacs是神的编辑器。
ReText&＃xff0c;也可以预览。

Web

推荐简书&＃xff0c;有 Markdown 写作/预览模式。
作业部落&＃xff0c;功能强大的 Markdown 编辑器。
与其他常用工具配合
在 Firefox 浏览器上&＃xff0c;推荐插件 It’s All Text!&＃xff0c;可以将网页上的文本框转化为 Markdown 编辑器。
在和 Evernote 配合使用时&＃xff0c;推荐使用马克飞象。

扩展阅读

《好用的 Markdown 编辑器一览》
欢迎补充&＃xff0c;随时更新。

2 Markdown 语法

现在可以在作业部落的左侧窗口中试试看了。无需注册&＃xff0c;直接开始输入文字就好。

要事第一

首先需要注意&＃xff1a;在 Markdown 中另起一段时&＃xff0c;需要多敲一次回车键&＃xff0c;来在段落之间添加一个空行。这是与其他常见文档格式的不同之处。
这是因为&＃xff0c;在一些 Markdown 解释器中&＃xff0c;会把相邻的两行合并成同一个段落。
例如&＃xff0c;当我们这样书写时&＃xff1a;
**这是第一段。
这是第二段。**
实际上看到的效果是这样&＃xff1a;
这是第一段。这是第二段。
虽然并非所有 Markdown 解释器都会用同样的解释方式&＃xff0c;但是为了避免出错&＃xff0c;还是多敲一次回车来添加一个空行吧。

标题

Markdown 中&＃xff0c;只需要在文本前面加上“#”&＃xff0c;就会被认为是加了一个标题。同理&＃xff0c;你还可以增加二级、三级、四级、五级标题和六级标题&＃xff0c;只需要增加“#” 即可。例如&＃xff1a;
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
列表
实际显示的效果是这样的&＃xff08;在不同的环境下显示效果可能会有差异&＃xff09;&＃xff1a;

二级标题

三级标题

四级标题

五级标题

六级标题

当你要罗列一些内容时&＃xff0c;列表是很有用的工具。为了说明哪些条目属于这个列表&＃xff0c;我们需要引入“项目标记”。

列表项目标记通常放在段落开头&＃xff0c;后面要跟着一个空格。列表的各个条目之间可以不留空行。

若列表中的条目没有特定顺序时&＃xff0c;可以使用 无序列表。加号“&＃43;”或减号“-”都可以作为列表标记&＃xff0c;后面要跟一个空格。例如&＃xff1a;

Red

Green

Blue

或者

Red

Green

Blue

实际显示的效果都是这样的&＃xff08;在不同的环境下显示效果可能会有差异&＃xff09;&＃xff1a;

• Red
• Green
• Blue

若想在段落前加上数字序号&＃xff0c;就需要用到有序列表了。使用数字、一个英文句号和一个空格即可。例如&＃xff1a;

1. Red

2. Green

3. Blue

实际显示的效果是这样的&＃xff08;在不同的环境下显示效果可能会有差异&＃xff09;&＃xff1a;

1. Red
2. Green
3. Blue

删除线

~~ 哈哈哈哈哈哈哈~~

实际效果&＃xff1a;

哈哈哈哈哈哈哈哈

图片

Markdown 中可以插入图片&＃xff0c;只需要感叹号、方括号和圆括号即可。例如&＃xff1a;
! [Alt text] (/path/to/img.jpg)
一个英文感叹号 “!” 后紧跟方括号&＃xff0c;里面可以写这张图片的说明&＃xff1b;再紧跟一对圆括号&＃xff0c;里面写这张图片的网址。例如&＃xff1a;
! [吃面条] (http://upload-images.jianshu.io/upload_images/19107-4a17a25a90d42a5e.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
实际显示的效果是这样的&＃xff08;在不同的环境下显示效果可能会有差异&＃xff09;&＃xff1a;

代码引用

需要引用代码时&＃xff0c;如果引用的语句只有一段&＃xff0c;不分行&＃xff0c;可以用 &＃96; 将语句包起来。
如果引用的语句为多行&＃xff0c;可以将&＃96;&＃96;&＃96;置于这段代码的首行和末行。
代码引用的案例截图&＃xff1a;

表格

相关代码&＃xff1a;

显示效果&＃xff1a;&＃xff08;第二行左边加冒号显示效果靠左&＃xff0c;右边加冒号显示效果靠右&＃xff0c;两边都加冒号显示效果居中&＃xff0c;注意&＃xff1a;冒号一定要和虚线紧挨着。&＃xff09;

相关代码&＃xff1a;

显示效果&＃xff1a;

显示链接中带括号的图片

代码如下:

![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)&＃43;1


3 常见问题

Q&＃xff1a; 我该去哪里下载 Markdown 软件&＃xff1f;

A&＃xff1a; Markdown 是一种标准而非软件&＃xff0c;任何支持 Markdown 语法的编辑器都可以使用&＃xff0c;无论是何种操作系统、哪类设备。请看“3 支持 Markdown 的编辑器”&＃xff0c;或者问问 Google。

Q&＃xff1a;在简书里怎么切换 Markdown&＃xff1f;为什么切换了没有反应&＃xff1f;

A&＃xff1a;建议使用 Chrome 或 Firefox 浏览器。在简书中&＃xff0c;点击右上角个人头像-设置&＃xff0c;在“常用编辑器”中选中markdown&＃xff0c;然后保存。注意一行小字&＃xff1a;“切换后对新建文章生效”。然后点击右上角”写新文章“&＃xff0c;再点击工具栏右侧倒数第三个按钮“切换到预览模式”&＃xff0c;屏幕应该会分成左右两个区域。在左侧区域输入内容、添加标记&＃xff0c;右侧就会实时显示 Markdown 效果了。

Q&＃xff1a; 为什么我按说明写了标记&＃xff0c;但是没法正常显示&＃xff1f;
A&＃xff1a; 很可能是你误把中文标点当成了英文标点。在 Markdown 中使用标点符号作为标记时&＃xff0c;要使用英文标点符号。没关系&＃xff0c;人们总会犯这种小错误。

Q&＃xff1a; 为什么我写了正确的标记&＃xff0c;但是在编辑窗口中看不到任何效果&＃xff1f;
A&＃xff1a; 许多 Markdown 编辑器都不是所见即所得的——“所见即所得”是指你对格式的修改会马上反映在屏幕上&＃xff0c;就像 Word 那样。如果你的编辑器没有没有实时预览功能&＃xff0c;就不会看到格式的变化。Macdown和简书 都支持实时预览&＃xff0c;你需要先打开这个功能&＃xff0c;才能看到这些格式标记的效果。

Q&＃xff1a; Markdown 可以排版表格吗&＃xff1f;
A&＃xff1a; 可以&＃xff0c;如果你熟练的话&＃xff0c;排版表格也会很快。表格的语法请见“Markdown 语法说明&＃xff08;简体中文版&＃xff09;”。

Q&＃xff1a; Markdown可以排版数学公式吗&＃xff1f;
A&＃xff1a; 可以。只要有相应的扩展&＃xff0c;Markdown 可以支持LaTeX 公式、甚至画流程图和甘特图。

Q&＃xff1a; 标题效果和加粗有区别吗&＃xff1f;
A&＃xff1a; 看似没有&＃xff0c;其实还是有的。这涉及到如何解释 Markdown 标记的问题&＃xff0c;一般和 CSS 有关。更多信息&＃xff0c;请看“4 扩展阅读”部分。

Q&＃xff1a; 加图片时&＃xff0c;无 IT 背景人士一般会采用从桌面拖拽的方式。Markdown 支持拖拽吗&＃xff1f;
A&＃xff1a; 拖拽图片插入文档或上传到网站&＃xff0c;不是 Markdown 语法本身的内容。不过有些网站和 Markdown 编辑器支持拖拽方式&＃xff0c;例如 Ulysess 和 简书 。

Q&＃xff1a; Markdown 正文可以调整字号吗&＃xff1f;
A&＃xff1a; 同样和解释 Markdown 标记的方式有关。更多信息&＃xff0c;请看“4 扩展阅读”部分。

Q&＃xff1a; Markdown 段落开头不能空两格&＃xff0c;看着很难受啊。有办法解决吗&＃xff1f;
A&＃xff1a; 办法嘛……若是在自己机器上的 Markdown 编辑器中&＃xff0c;也许你可以修改 CSS。若是在 简书 之类网站上&＃xff0c;可能只能手工在每段开始前手工添加五个“&n bsp;”了。记得&＃xff0c;是“&nb sp;”&＃xff0c;字符和字母之间都没有空格。最后的分号也是有必要的哦~

4 扩展阅读

更多关于 Markdown 语法或工具的内容&＃xff0c;可以参考&＃xff1a;
Markdown 语法说明&＃xff08;简体中文版&＃xff09;
献给写作者的 Markdown 新手指南
Markdown 是定义文章逻辑结构&＃xff0c;而非定义样式的。一般来说&＃xff0c;Markdown 最终呈现出的样式&＃xff0c;是由对应的层叠样式表&＃xff08;CSS&＃xff09;所定义的。如果想要自己调整出想要的样式&＃xff0c;可以从 CSS 开始。这里有一份 CSS 教程&＃xff1a;《CSS 入门教程》

Markdown 新手手册&＃xff08;本文&＃xff09;

更多内容&＃xff0c;请关注专题《GC4WPS03E05-番外》

5 补充

1. 左右两边加~ &＃xff1a;~ 123456 ~
   实际效果&＃xff1a;₁₂₃₄₅₆
2. 左右两边加 ·&＃xff08;Tab上边的键&＃xff09;&＃xff1a; **·**123456 ·
   实际效果&＃xff1a;123456

• 父类的无序标号
  • - 横线前面空两个空格&＃xff0c;后面空一个空格&＃xff0c;出现小白圈