Markdown 使用手册

这个页面是用于大家发布页面而共同学习,而简化大家学习 HTML 显示页面的内容。如果你想写文章并发布的话,可以与我们联系,并提交文章的 Markdown 代码(*.md 文件)给我们即可,我们可以直接给你编译为 HTML 代码并直接发布于网页上显示出来。

HTML 和 Markdown 介绍

HTML,Hyper Text Markup Language,超文本标记语言,指的是显示在页面上的文字、表格、标题、加粗文本等一系列不同的约定好的标记语言。不过它的代码过于复杂,随后发明了一种轻量级标记语言,操作起来会比 HTML 更加轻松。它被称为 Markdown 语言。它在编译期间,会被编译转换为复杂的 HTML 代码。

由于操作方便和简单,而且可以编译为显示功能更多的 HTML,所以被广泛使用在电脑做笔记和很多网页介绍文档之中。

使用手册

接下来将介绍所有关于 Markdown 语言的表述方式。

基本文本(Basic Text)

你可以随意输入一行文字即可称为基本文本,不过换行时,请输入两次回车。因为 HTML 代码的解析过程是不包括回车和多次空格的(或者说不识别),如果你想另起一行写新的一段文字时,请输入两次回车:

 

将生成:

This is a test paragraph.

 

将生成:

This is paragraph one. This is paragraph two.

注意上方示例,是没有换行显示的。

 

将生成:

This is paragraph one.

This is paragraph two.

转义字符(Escape Character)

转义字符指的是,字符在 Markdown 或 HTML 之中有别的用途的字符(符号),在直接显示这一类符号时,需要在其前面添加反斜杠 \ 进行转义后才可直接显示该字符。

常见的转义字符有:

例如:

 

将生成:

C:\Windows\System32。

标题(Title)

你可以为你的文章创建标题。标题使用单个井号 # 或是多个井号来注明标题。标题一共提供了六种形式,分别对应文章的“第 a 章”、“a.b节”、“a.b.c小节”、“a.b.c.d小节”、“a.b.c.d.e小节”和“a.b.c.d.e.f小节”。

 

将生成:

第一章

第一节

第1.2.3.4小节

删除线(Deleteline)

你可以使用两个波浪线符号 ~~<del></del> 来显示删除文本。

 

将生成: 我有一顶绿红帽子。

 

将生成: 我今天数学又得 100 分了其实并不是

有一些 Markdown 编译器并不支持 ~~ 这个符号,所以

下划线(Underline)

你可以使用 <u></u> 对字加下划线。

 

将生成:

有下划线的文本是这里

粗体字(Bold)

你可以使用两个星号 ** 来加粗文字。

 

将生成:

这是加粗文字

斜体字(Italian)

你可以使用一个星号 * 来显示斜体字。

 

将生成:

这是斜体字

无序列表(Unordered List)

你可以使用 *+- 的其中一种来生成一个列表。

 

将生成:

C# 语言的基本数据类型有:

但请注意的是,无序列表后插入的新的一段文本,依然需要两次换行。

另外,你还可以使用两个空格加上一个星号,来将列表内元素再一次分类。

 

将生成:

C# 的数据类型有:

有序列表(Ordered List)

有序列表则只需要将无序列表之中的三种符号更改为数字加上小数点的形式即可。

 

将生成:

  1. 第一点
  2. 第二点
  3. 第三点
  4. 第四点

注意,输入的数字不一定需要按顺序,比如全部输入 1.,依然会生成有序列表。不过不建议这样,因为这样可读性并不好。

引用(blockquote)

你可以使用一个大于符号 > 来引用一段外来的文字(比如名人名言之类),或是写出注释和注解等。

 

将生成:

有一句话说得好:

Well begun is half done. 好的开端是成功的一半。

所以我们要好好学习!

高亮强调文字(Highlighted Text)

你可以使用两个等号 == 将需要高亮的文字夹在两组两个等号之间。或者使用 <mark></mark> 的 HTML 标签。

 

将生成:

这是强调文字

此语法在基础 Markdown 版本下不支持,需要有拓展之后的语法才会支持。

字体上色(Colored Text)

字体上色在 Markdown 语言之中是没有对应的符号的,不过你可以使用原生的 HTML 代码实现字体的不同颜色的显示。你可以输入 HTML 的标签: <font color="颜色值"></font> 来实现。

 

将生成:

这是红色字。

这是蓝色字。

这是紫色字。

这是其他颜色的字。

如果你要查询color里的参数“颜色值”到底如何用的话,请搜索“HTML 颜色值”来进行查看。

超链接(Hyperlink)

你可以输入 []() 来显示一个超链接(可以点击后前往下一个页面的东西)。

 

将生成:

文档库首页

你可以点击“文档库首页”几个字,并直接前往至首页。

图片(Image)

你可以输入 ![]() 来显示一个图片。

 

将生成:

这是一个可爱的动漫女生。

图片下方的文字

添加图片时,小括号 () 内填入的是图片的存放位置,可以是本地的存放位置,也可以是某个网站上的图片的网址,不过请注意的是,如果图片文件是当前文件夹下的话,可以直接写图片的名字和后缀名即可(比如 testPic.jpg);但是如果是跨文件夹时,需要先写斜杠 /,然后输入文件夹的相对地方,然后直至检索到文件所在文件夹时。

代码(Code)

代码用于开发者人员在网上写授课文件时用得到。一般代码贴上去时,将这段文本缩进四格,或是用两组三个反引号 ``` 把代码夹在里面来表示。

 

注意上面的缩进。

将生成:

 

但是,一般的编译器都不会为代码里面出现的关键字或是标点符号添加颜色,这需要使用更为高级的、自动上色的编译器。不过,如果你需要添加颜色的话,你可以使用 Notepad++ 软件下的 NppExport 插件直接生成带有颜色效果的 HTML 代码。它会生成如下类似的带颜色的代码形式:

public static void Main(string[] args)
{
    Console.WriteLine("Helloworld");
}

其大致等效的 HTML 代码写法如下:

 

不同的渲染(电脑制作显示出来的颜色形式)会略有差异。