使用markdown语法撰写csdn博客

在CSDN之下写blog无疑是一件很吃力的事情，对于很多simple爱好者来讲，能用markdown语法来书写代码是最优雅简洁不过的了。本文主要介绍markdown语法和如何它来撰写csdn下的blog。

1 基本原理

撰写csdn博客有两种模式，源代码模式和可视化模式，其中可视化模式是我们最常用的，源代码模式主要是html语法。通常模式下，我们不会选用源代码模式，但是，我们可以将源代码模式作为中间输出，来沟通markdown和可视化博客。简单而言，我们直接撰写mardown文档，通过python脚本转化成html放到csdn的blog编辑器中，然后生成blog。所以，这里面一个很关键的地方在于撰写将markdown转化成html的python脚本。

2. 功能python脚本

脚本的功能是将markdown语法转变成html文件。代码如下：

  
  

   
   
#!/usr/bin/python  
#coding utf8  
import  markdown  
import  sys  
sys.defaultencoding=('utf8')  
sys.defaultdecoding=('utf8')  
filename=sys.argv[1]  
markfile=open(filename)  
markcontent=markfile.read();  
print "markcontent type:", type(markcontent)#str ob  
htmlcontent=markdown.markdown(markcontent.decode('utf8'))#  
print "htmlcontent type:", type(htmlcontent)#unicode ob  
htmlfilename=filename+".html"  
htmlfile=open(htmlfilename, "w")  
htmlcontent=htmlcontent.encode('gbk')#translate into str  
htmlfile.write(htmlcontent)  
htmlfile.close()  
markfile.close()  
  
  

功能比较简单，不在此解释，下面两部分介绍markdown的具体语法。

3 区块元素

3.1 段落与换行

换行需要插入一个明显的空行来实现，也就是说，需要连续两个换行符号。

效果：

这是第一段

这是第二段

代码：这是第一段（两次换行）这是第二段

3.2区块引用

区块引用是>来实现的，效果如下：

This is a block

对应代码：> This is a block

注意：区块引用，并没有屏蔽内部的markdown语法解析。

问题：如果一个区块引用包含几个段落那么该如何处理呢？

答： 每个段落之前，都加上区块引用符号，效果：

First para in a block

second para in the block.

>First para in a block

>second para in the block.

3.3标题

标题是通过#实现的，#个数的多少，表示标题的等级。

效果：

first head

second head

third head

实际代码：

#first head
##second head
###third head

问题:区块元素会自动添加换行符吗？

答：标题元素确实会添加换行符号, 但是其他区块元素不会添加换行符号。

3.4列表

无序列表使用*、+、-来作为列表标记，标记后面最少跟着一个空格，效果：

• red
• green
• blue

代码如下：

* red
* green
* blue

注意：列表和标题一样，会自动换行

答：通过缩进来引用代码，代码内部的markdown解析将被屏蔽。

列表项包含多个段落的时候，我们将在第二个段落之后，每个段落开始，加上四个以上的空格或者制表符，这样就可以实现下面的效果：

1. first of a table

   second of a table

另外，列表中并没有屏蔽markdown语法，可以在列表中放入区块，也可以放入引用代码块。在列表中放入缩进的情况如下：

这里是缩进之后

3.5 code block

我们来看看代码块的语法：

int main()
{
    int a;
}

3.6 分割线

分割线的语法是三个以上的","、"-"、"_"，效果如下

---

4. 区段元素

4.1 链接

markdown 支持两种链接模式，行内式和参考式：都用“ []”来引用链接文字。

行内式的链接语法与效果如下：

[google](http://www.google.com"the character you will see when mouse on")

google

4.2 强调

使用一对“ *”或者一对“ -”来标记需要强调的内容；使用一对两个“*”或者“-”来对字体进行加粗。效果如下：outstanding，and,strong。值得注意的是，符号两边不能含有空格，否则，这些符号将被当作符号本身进行解析；另外，我们同样可以使用反斜线来转义它们.outstanding, andstrongoutstanding, andstrong

更多语法介绍可以参考这里：markdown 语法介绍

4.3 小块代码

使用单个反引号来表示小块代码引用，效果如printf

转自：http://blog.csdn.net/trochiluses/article/details/23996989