• xpluslus.cn不支持html标签,md里的标签会直接以文本的方式展示,如果需要表格,请使用图片替换;
  • 不要对<, >, & ', "进行html实体转换,直接使用他们即可;

除了这两点外,xplusplus.cn支持所有的Markdown语法。


Markdown是一个简单的标记语言,它的目标是实现「易读易写」,适合用来编写文档。

Markdown源文件被解析之后得到的是HTML代码,和HTML源代码不一样,一份使用 Markdown格式撰写的源文件应该可以直接以纯文本发布, 并且看起来不会像是由许多标签或是格式指令所构成,也就是说,直接阅读Markdown源文件,也有很好的体验。

本文档假设读者完全不了解HTML,如果读者熟悉HTML代码,本文档底部的参考链接可能更适合。

建议读者在看这个文档的同时,在所见即所得的Markdown编辑器里试用对应的语法。在本文档的底部有这些编辑器的推荐。

1.段落和换行

Markdown的段落前后需要一个以上的空行,这意味着在你完成一个段落后,需要连续敲下两个回车以开始新的内容。如果你第一次使用Markdown,这可能会让你很费解,但当你完成几个段落之后,你会发现,这些空行大大提高了Markdown源文件的可读性。

2.标题

#开头可以定义一个标题,#的数量决定标题的级数。

# 这是一级标题

## 这是二级标题

###### 这是六级标题

为了Markdown源文件的可读性,也可以在标题后面加上等量的#

# 这是一级标题 #

## 这是二级标题 ##

###### 这是六级标题 ######

也可以使用下面的方式定义标题

第一级标题
=============

第二级标题
-------------

=或者-的数量至少是3个。显然,这种方式表示的标题级数有限。

3.列表

Markdown 支持有序列表和无序列表。

无序列表使用星号、加号或是减号接着一个TAB作为列表标记:

*   Red
*   Green
*   Blue

等同于:

+   Red
+   Green
+   Blue

也等同于:

-   Red
-   Green
-   Blue

有序列表则使用数字接着一个英文句点,然后一个TAB:

1.  Bird
2.  McHale
3.  Parish

有趣的是,在列表标记上使用的数字的顺序并不会影响输出。但是为了源文件的可读性,请按顺序写这些数字。

4.代码

如果要表示行内代码,可以使用反引号`把代码括起来。

在C语言中,使用`printf`函数可以进行格式化输出

如果很不幸,你的代码中刚好也有`,可以使用多个`把代码括起来。

在shell脚本中,使用反引号可以将其中的字符串当成shell命令执行,返回命令的执行结果: ``CURRENT_PATH=`foo```

要在 Markdown中建立整块的代码很简单,只要简单地将所有代码行缩进一个TAB就可以。

N的阶乘末尾有多少个0的算法如下:

	int find_zeros(int n)
	{
		int num = 0;
		int i,j;
	
		for (i = 5;i <= n;i += 5)
		{
			j = i;
			while (j % 5 == 0)
			{
				num++;
				j /= 5;
			}
		}
	
		return num;
	}
	
算法思路:...

一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。

5.图片

Markdown有两种表示图片的方式: 行内式和参考式。

行内式的图片语法如下:

![替代文字](/path/to/img.jpg)

![替代文字](/path/to/img.jpg "可选的标题")

描述如下:

  • 一个惊叹号!
  • 接着一个方括号,里面放上当图片不存时的替代文字
  • 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上可选的标题,当鼠标悬浮在图片上时,会显示该文字。

参考式的图片语法则长得像这样:

![替代文字][id]

「id」是图片参考的名称,图片参考的定义可以出现在任意位置,格式如下:

[id]: url/to/image  "可选的标题"

格式具体描述如下:

  • 方括号(前面可以选择性地加上至多三个空格来缩进),里面输入链接id
  • 接着一个冒号
  • 接着一个以上的空格或TAB
  • 接着图片的位置
  • 接着可选的标题,可以用单引号、双引号或是括弧包着

6.链接

和图片类似,链接也支持 行内式和参考式和参考式两种定义方式。

不管是哪一种,链接文字都是用 [方括号] 来标记。

要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 链接标题文字,只要在网址后面,用双引号把 链接标题文字包起来即可,例如:

这是一个[链接文字](http://example.com/ "链接标题") 行内连接.

[这个链接](http://example.net/) 没有链接标题.

当鼠标停留到链接上时,会显示链接标题文字。

参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以唯一标识链接的标记:

这是一个 [链接文字][id] 参考式的链接.

接着,在文件的任意处,你可以把链接参考定义出来,格式和定义参考式图片类似:

[id]: http://example.com/  "链接标题"

7.引用

如果要在文章中加入引用的内容,可以在引用内容的每行的开头处加上>:

Linus Torvalds大师曾经说过:

>The Linux philosophy is 'Laugh in the face of danger'. 
>Oops. Wrong One. 'Do it yourself'. Yes, that's it.

也可以只在每个段落的开头处加上>,当要引用的内容很多时,这样可以节省很多时间。

引用可以嵌套,也即引用中可以有引用,只要根据层次加上不同数量的>:

> 伟大的文学家鲁迅先生曾说过,孔子说:
>
> > 学而时习之,不亦乐乎!
>
> 这里回到第一层引用。

引用里面也可以嵌套其他的Markdown元素。

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码:
> 
>     return shell_exec("echo $input | $markdown_script");

8.其他

分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

* * *

***

*****

- - -

---------------------------------------

强调

Markdown 使用星号*和下划线_作为标记强调字词的符号,标记符的个数可以是一个或者两个,两个符标记符的强调程度比一个高

*单个星的强调*

_单个下划线的强调_

**两个星的强调**

__两个下划线的强调__
如果*或者_两边都有空白的话,会被当成普通字符

自动链接

Markdown支持以比较简短的自动链接形式来处理网址和电子邮件地址,只要是用尖括号包起来, Markdown 就会自动把它转成链接。

我的独立博客地址是:<http://example.com/>

如果有问题,请联系:<address@example.com>,谢谢

使用反斜杠转义关键符号

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果,你可以在星号的前面加上反斜杠:

\*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

推荐使用下列Markdown编辑器:

参考文档:


相关链接:

  1. xplusplus.cn简介
  2. wordpress插件connect2xpp
  3. 有哪些技术大牛加入了xplusplus.cn?
  4. 如何使用connect2xpp插件把独立博客聚合到xplusplus.cn?
  5. 搜索引擎xppgo!
  6. 如何在xplusplus.cn中发布文章?
  7. Markdown语法指南