Markdown 写作教程及语法指南

本文内容参考了Markdown 语法说明 (简体中文版),使用WP-MarkPad和MarkdownPad 2编写完成。主要学习目的是了解Markdown简要语法及常用方式。如标题,段格,格式,列表等,这些都是日常写文字时常用的。@chojemmy 说 Markdown 是留给程序员用的。或许是吧,但在写纯文字时,它也是非常支持的。

我之所以用Markdows是它转成XHTML的标准吸引了我,同时所以文章通过Markdown编写,显示出来的文章事前事后没有任何插件对它产生影响,因为它已以完全标准的XHTML格式显示出来。这方便那些时不时换插件的朋友来说是一个不错的选择,特别是写代码比较多的朋友,也就是@chojemmy 的程序员。

一、Markdown兼容HTML语法
所以直接输入的HTML语句,会按HTML代码解析。 如果你的HTML代码够厉害那完全书写出来既可。

二、Markdown的标题方法一:

一级标题
======
二级标题
---------

效果:

一级标题

二级标题

三、Markdown的标题方法二:

#一级标题
##二级标题
###三级标题
最小标题可以达6级标题,也就是H6.  

效果:

一级标题

二级标题

三级标题

四、区块引用,使用>符号,而且能嵌套,并且其中还能再使用其他的语法。

>会缩进
>>还能嵌套,比上一级缩进更多
>>>再来一条,还能使用其他语法

效果:

会缩进

还能嵌套,比上一级缩进更多

再来一条,还能使用其他语法

五、无序列表,使用*、+、-即可。

+ 列表内容1
+ 列表内容2
- 列表3
- 列表4
- 注意:符号与文字中间还有一个空格。

效果:

  • 列表内容1
  • 列表内容2
  • 列表3
  • 列表4
  • 注意:符号与文字中间还有一个空格。

六、有序列表,数字+英文点

1.有序列表1
2.有序列表2
3.有序列表3
4.有序列表4

效果:

1.有序列表1
2.有序列表2
3.有序列表3
4.有序列表4

七、代码区块每一行前面都要加四个空格或者一个tab位

#this is code
print "Hello, World!"  

效果:

#this is code
print "Hello, World!"

八、分割线,这一行要有三个以上的*、-、_ 而且没有除了空格之外的其他符号

***
---

效果:

****

九、行内链接,可使用相对路径和绝对路径,title属性,可以使用单、双引号和括号

[佐仔志](https://www.jinbo123.com "佐仔志")

效果:

佐仔志

十、参考链接,标记的冒号后边至少有一个空格或制表符,title属性可以另起一行,可以加缩进

[佐仔志][jinbo]
[Google][]
[Jinbo]: https://www.jinbo123.com/
[Google]: http://www.google.com/

效果:

佐仔志
Google
十一、强调,使用*号或者_包围要强调的内容,就是让所包围文字粗体显示

*斜体*
__粗体__
**粗体**

效果:

斜体
粗体
粗体

十二、行内代码段,使用反引号`包围,就是ESC键下边的那个键

this is how the 'printf()' work。

效果:

this is how the printf() work。

十三、行内图片,支持绝对链接和相对链接,类似行内链接

我的头像![头像](http://0.gravatar.com/avatar/eece4ac89edd4a2d86e69314a3ba7fd9?s=44&d=&r=G "title可省略")

效果:

我的头像头像

十四、参考图片,类似参考链接

我的头像![我的头像][pic]
[pic]: http://0.gravatar.com/avatar/eece4ac89edd4a2d86e69314a3ba7fd9?s=44&d=&r=G "title可省略"

效果:

我的头像我的头像
十五、强大的反斜杠,和编程时候字符串里的转义一个意思啦,就是想输出[]之类的符号,而不想让它被识别为markdown语法符号的时候,在这些符号前加个**

\###这不是\*标题\*,但*这个*会斜体

\[佐仔志][https://www.jinbo123.com/]

效果:

这不是*标题*,但这个会斜体

[佐仔志][https://www.jinbo123.com/]

OK,基本上主要的内容就是这些了,比较好记,当然想用的高级也不是那么容易啦,我也是个初学者,如空行、空格等内容还不是很明白,文中内容可能也会有些地方不太准确,望指正。编写过程参考了Markdown 语法说明 (简体中文版)

注意:所有换行 </br> 都是按两个空白键再回车,这样才会另起一行,否则解释出来的XTHML是同一行显示。

Markdown 写作教程及语法指南》有2个想法

    1. 佐仔

      WP-Markdown,就这个。不过有一点不好的就是没有“阅读全文“的代码标签,必须用纯代码。
      如果你对Markdown很熟悉,那可以用Markdown on Save Improved插件,它是用原来的编辑框,然后支持Markdown语法,但它不支持代码高亮。

      回复

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注