Markdown格式简明教程

校内外客服   2014-01-05 09:53

  『校内外 xnw.com』的日志支持Markdown格式,这是一种可以设置字体颜色、大小,插入表格、照片等复杂的排版格式。本文是Markdown格式的简明教程,可以让您很快就能写出漂亮美妙的日志,是不是很酷?

最后更新:2013-8-8

  • 一、准备、FAQ
    1.如何打开“Markdown格式”开关?
    2.怎么使用Markdown格式?
    3.为什么不默认打开Markdown格式开关?
    4.如何正常显示特殊字符(转义)
    5.有哪些“特殊字符”
    6.如何学习Markdown格式?
  • 二、基本的Markdown格式命令
    1.加粗、斜体
    2.标题
    3.缩进
    4.引用
    5.列表
    6.表格
    7.分隔线
    8.网络链接
    9.插入图片
  • 三、内嵌HTML
    1.删除线、下划线
    2.字体的大小与颜色
    3.段落的居中、居右
  • 四、更多内容

一、准备、FAQ

  看完这一部分,您将知道如何让您的日志支持Markdown格式,了解Markdown格式怎么用,以及如何让Markdown格式用得好。

1.如何打开“Markdown格式”开关?

  要让您的日志支持Markdown格式,需要在“我的设置/偏好设置http://xnw.com/my/custom里,把“写日志格式”设置为“Markdown”,然后点击“保存”。这样您就可以在日志里使用Markdown格式了。

2.Markdown格式是怎么工作的?

  不同于其他的排版软件,“Markdown格式”,是直接“写”到日志里的。比如,您把下面的文字拷贝到您的日志里:

我的**日志**现在*漂亮*啦!

  效果如此:


我的日志现在漂亮啦!


  所以您可以看到的是:U>把文字用双星号括起来,就可以加粗。用单星号括起来,就可以变斜体。/U>

3.为什么不默认打开Markdown开关呢?

  正由于Markdown格式是写入正文的,因此必然有些字符有特殊含义,当您无意中输入这些字符,或者您希望显示这些字符本身时,却会被解释成格式命令。因此,除非您了解或者希望学习Markdown格式的使用,否则我们并不建议您打开“Markdown”这个开关

4.如何正常显示特殊字符(转义)

  如何正常显示特殊字符,并避免被解释为格式命令呢?

  Markdown格式提供了三种叫做“转义”的方法:

  • 第一种方法,是在特殊字符前加一个反斜杠(\)。比如您想输入“*正常字体*”(也就是不让中间四个字变成斜体),您可以输入“\*正常字体\*”。当然,如果您想输入一个反斜杠,您可以连续输入两个反斜杠,如“\\”。

  • 第二种方法,是使用两个反单引号(`)把您的字符或字符串“括”起来。比如您希望正常显示邮件地址而不会让@后面被解释成用户名,您就可以这样:

    service`@`xnw.com
  • 第三种方法:使用Markdown格式的“引用”命令。请看下面。

5.有哪些“特殊字符”

下面的清单供参考:

特殊字符 说明 转义方法
反斜杠(\) 转义符 \\
反单引号(`) 转义符 \`
@ 引用用户名、群名 `@`
小于号(<) HTML命令 `<`

6.如何学习Markdown格式?

  Markdown格式是需要学习的。不过大家也不必被这些命令吓到。其实了解Markdown格式的基本原理后,先学会“转义”,然后再记住几个常用的技巧(加粗、标题、列表等等)就可以了。如果您需要更多有趣的技巧,到时再查这个手册就可以了。

二、基本的Markdown格式命令

  这一部分向大家介绍一些很基础却很有用的Markdown格式命令。

1.加粗、斜体

  使用双星号“**”把文字括起来就是加粗,使用单星号“*”把文字括起来就是斜体啦。比如:

我要*斜体*
我要**加粗**
我要***加粗并斜体***

2.标题

  标题应该是单独一行,在这行文字前加1~6个井号“#”,就可以把这一行定义为1级~6级标题。比如:

#这是一级标题
##这是二级标题
###这是三级标题
####这是四级标题
#####这是五级标题
######这是六级标题

3.缩进

  缩进很简单,在您要缩进和段落前加一个大于号“>”就可以了,如果连打两个大于号,就缩进两次。注意的是,紧挨着的下一行也会缩进的。如果需要停止缩进,需要加一个空行。比如:

>这行需要缩进
第二行也需要缩进
>>这一行缩进两次

这一行不需要缩进了

效果如此:


这行需要缩进
第二行也需要缩进

这一行缩进两次

这一行不需要缩进了


4.引用

  所谓引用,是指带有淡淡底色的段落(大家在前面已看到了吧)。引用里面的Markdown的命令是不解释的。要实现这个效果,只需要引用的文字前,加上一个空行,然后以4个或以上的空格开头就可以了。例如:

    这是引用的文字。前面加4个空格就可以了。

5.列表

  列表有两种,一种是“无序号列表”,另一种是“有序号列表”。

  • 列表前后,都需要插入一个空行。
  • 无序号列表的每一项目都以一个星号(*)、加号(+)或减号(-)作为项目标记,有序号列表以一个数字后跟一个小数点(.)为项目标记。项目标记前面可以插入最多3个空格,后面插入一个或多个空格。
  • 项目之间可以有空行,也可以没空行(项目之间会紧凑一些,即没有段落间隔)。
  • 如果项目有多行,第二行起可以插入空格以便跟前面对齐(可以不加)。
  • 如果某个项目有多个段落,段落间需要加空行,并且从第二个段落开始,每个段落的第一行前面,需要插入4个空格。
  • 有序项目的数字可以连续,也可以不连续。但显示时都会自动显示为连续的数字。

例如:

无序列表:

  - 这是无序项目1
  - 这是无序项目2
    这是无序项目2的第二行

    这是无序项目2的第三行

  - 这是无序项目3

有序号列表:

  1. 这是有序项目1。
  3. 这是有序项目2。

  2. 这是有序项目3。

效果如此:


无序列表:

  • 这是无序项目1
  • 这是无序项目2
    这是无序项目2的第二行

    这是无序项目2的第三行

  • 这是无序项目3

有序号列表:

  1. 这是有序项目1。
  2. 这是有序项目2。

  3. 这是有序项目3。


6.表格

  要插入一个表格,您需要定义一行标题(第一行),一行表格定义(第二行)、一个或者多个表行。每行可以有多个列,每列之间用“|”分隔。表格前后都需要一个空行。例如:

科目|成绩|说明
:--:|---:|----
数学|105|第一行是标题。第二行是表格定义
课外实践|98|第三行开始是表格正文

效果如此:


科目 成绩 说明
数学 105 第一行是标题。第二行是表格定义
课外实践 98 第三行开始是表格正文

可以看到,第二行同时规定了每列的对齐方式:左齐(----)、居中(:--:)、右齐(---:)。

7.分隔线

  您可以在一行中用三个以上的星号(*)或者下划线(_)来建立一个分隔线。行内不能有其他东西,但星号之间可以有空格,比如下面的都可以产生分隔线:

****
* * * *
___
_______________

8.网络链接

  插入网络链接最简单的方法是直接输入网址(如http://xnw.com),这时如果网址比较长,系统有可能会转换成一个http://xnw.com/s/ 打头的短域名。如果不希望系统进行转换,可以用尖括号把URL括起来。另外还可以使用下面的方法,这样可以做到显示一个带连接与浮动提示的文字串:

无提示的:[校内外](http://xnw.com)
有提示的:[校内外](http://xnw.com "校内外·成长路")

9.插入图片

  在日志中间插入一个图片,可以先把图片上传到相册,然后取得该图片的网址,然后使用下述方法(其中,浮动提示的文字也可以省略):

![校内外](http://xnw.com/images/xnw_logo%401x.png "校内外·成长路")

三、内嵌HTML

  Markdown格式有一个很有用的功能,也是更“高级”(也就使用更复杂、功能更强大)的功能,就是支持内嵌HTML,也就是说,您可以把绝大多数的HTML命令加入到您的日志里,从而进一步丰富您的日志格式。下面介绍一些简单且常用的HTML命令。

1.删除线、下划线

  使用简单的HTML命令(<S><U>),可以实现删除线下划线。例如:

我们要<s>删除线</s>,还是<u>下划线</u>?没有问题!

  注意:<s>,</s><u>,</u>一定要成对出现。

2.字体大小、颜色

  设置字体的大小与颜色,要用到<font>语句:

我们想要<font size=5 color=red>大一点的红字</font>!

  其中,字体大小为1~7(由小到大),颜色可以是常用的英文颜色名(可以看这里,或者类似“#FF00FF”(三组16进制的RGB颜色值)的格式。效果如此:


我们想要大一点的红字


3.段落的居中、居右

  要用到两个HTML命令:

<center>这一行需要居中</center>
<div align=right>现在居右了吧</div>

  看看效果:


这一行需要居中
现在居右了吧

四、更多内容

  本文的内容针对『校内外 xnw.com』的日志系统,并不能作为通用的Markdown教程。

  同时,本文也将根据系统的进展,以及用户的需求而不时更新。欢迎大家随时阅读最新的线上版本。

  如果大家发现有任何疑问,或者有任何意见,请随时在本日志下方评论。

收藏 17

修改于 2015-03-16 | 阅读量 32784
| 8

以上为置顶评论

#1

2015-03-16 16:24 回复

这篇文章中的截图该换掉了 @校内外客服晓达
#4

2016-06-28 17:13 回复

#5

2016-11-07 10:49 回复

#6

2017-04-01 11:06 回复

#7

2017-07-25 10:01 回复

#8

2018-02-02 11:50 回复

#9

2019-12-07 18:11 回复

[太阳]
快速上传 本地图片 网络图片

图片 个上传失败, 重新上传

附件 最多上传12个文件