Markdown 常用语法教程

zxc7895531 发表于 2018-10-25 20:54:42 | 查看:777 | 教程


本篇教程由 @zxc7895531 以及 @KasuganoSoras 撰写,还有不懂的可以回复本帖询问,最好

Markdown 的目标是实现「易读易写」。

可读性,无论如何,都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。Markdown 语法受到一些既有 text-to-HTML 格式的影响,包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText,而最大灵感来源其实是纯文本电子邮件的格式。

本篇教程将会教你如何使用 Markdown,ZeroDream 论坛是一个支持 Markdown 的论坛,无论是发帖、回复还是签名档,都支持 Markdown 语法。

一、文字和标题


显示粗体字

字体可以加粗显示,以突出主题

** 这是一段简单的加粗字体 **

效果如下:

Test


标题分级

通过不同级别的标题可以突出主题

一级大标题:
# This is number 1
二级标题:
## This is number 2
三级标题:
### This is number 3
四级标题:
#### This is number 4
五级标题:
##### This is number 5
六级标题:
###### This is number 6

演示:

This is number 1

This is number 2

This is number 3

This is number 4

This is number 5
This is number 6

字体效果

插入一段斜体字的方法

*这是一段简短的内容*
***这是一段加粗的斜体内容***

效果如下:

这是一段简短的内容
这是一段加粗的斜体内容


引用

通常引用可以用来突出显示某一段内容(当然它的原作用是用来引用一段话)

> 这是一段内容

效果如下:

这是一段内容

而引用是可以支持多段引用的,只要你下一行不是空行,都可以继续引用

> 第一行内容
第二行内容
第三行内容

结束引用

效果如下:

第一行内容
第二行内容
第三行内容

结束引用

二、表格和列表


表格

下面是一个简单的表格书写方法

| 表头一 | 表头二 | 表头三 |
| --- | --- | --- |
| 内容一 | 内容二 | 内容三 |
| 第二行 | 第二行 | 第二行 |
| 最后一行 | 最后一行 | 最后一行 |

效果如下

表头一 表头二 表头三
内容一 内容二 内容三
第二行 第二行 第二行
最后一行 最后一行 最后一行

请注意,表格开头与上一句必须要空一行,否则会无法解析出表格

同时表格也支持居左,居中,居右。

| 居左 | 居中 | 居右 |
| :--- | :---: | ---: |
| 内容一 | 内容二 | 内容三 |
| 第二行 | 第二行 | 第二行 |
| 用足够长的内容 | 撑开最后一行 | 效果才比较明显 |

效果如下:

居左 居中 居右
内容一 内容二 内容三
第二行 第二行 第二行
用足够长的内容 撑开最后一行 效果才比较明显

有序列表

下面是一个有序列表的书写方法
值得注意的地方是,列表左侧的数字不一定要按照顺序,即使你全部写 1 或者其他数字,只要是数字,它就会自动排序。

1. 第一行内容
2. 第二行内容
3. 第三行内容
4. 第四行内容

效果如下:

  1. 第一行内容
  2. 第二行内容
  3. 第三行内容
  4. 第四行内容

无序列表

下面是一个无序列表的书写方法
无序列表左侧的符号可以是星号、加号或是减号

* 第一行内容
* 第二行内容
* 第三行内容
* 第四行内容

效果如下:

  • 第一行内容
  • 第二行内容
  • 第三行内容
  • 第四行内容

用 - 或者是 + 都可以作为标记

- 第一行内容
- 第二行内容
- 第三行内容
- 第四行内容

三、链接和代码


超链接

Markdown 支持行内式和参考式两种插入链接的方法。

行内式的链接可以这样写

[Sakura Frp](https://www.natfrp.org/)

效果如下:

Sakura Frp

参考式的链接写法也很简单,你可以把参考式理解为:在一个地方定义好变量,然后在另一个地方输出变量。

比如我们可以先在某个地方写一个链接,名字就叫 alink,注意名字只能是英文和数字组成。

[我是一个链接](alink)

然后我们在其他地方写

[alink]: https://www.natfrp.org/

然后你就可以看到这样的效果

我是一个链接

这样你就可以得到一个简单、清爽的帖子:先在文章中定义链接名称,然后找个地方比如文章底部再批量定义链接地址。


行内代码和代码块

行内代码指的就是一行内的代码,根据下面这个小例子你可以很轻松地了解什么是行内代码。

首先我们下载 `Sakura_frpc_linux_amd64.tar.gz`,然后使用命令 `tar -xzvf Sakura_frpc_linux_amd64.tar.gz` 解压,最后设置一下可执行权限 `chmod +x Sakura_frpc_linux_amd64` 就可以通过命令 `./Sakura_frpc_linux_amd64` 来运行客户端了。

效果如下:

首先我们下载 Sakura_frpc_linux_amd64.tar.gz,然后使用命令 tar -xzvf Sakura_frpc_linux_amd64.tar.gz 解压,最后设置一下可执行权限 chmod +x Sakura_frpc_linux_amd64 就可以通过命令 ./Sakura_frpc_linux_amd64 来运行客户端了。

可以看到,这里的代码高亮是出现在一行内的,代码内容就用 ` 来隔开(键盘切换到英文输入法,左上角数字 1 左边的)

代码块指的就是一片代码,举例
为了防止转义,这里是一张图片
效果如下:

<?php
echo "Hello World"; // 一段代码
?>

当然,你也可以用一个 Tab 键或者 4 个空格来插入代码块

    <?php
    Hello World
    ?>

代码块的第一行和最后一行必须要与其他行保持一个空行的举例。


四、插入图片


学习 Markdown 最重要的事情之一就是学会如何插入图片。

其实插入一张图片很简单。

![图片介绍,可空](图片链接)

举例

![迷人の笑](https://cdn.tcotp.cn:4443/images/xjj.png)

效果如下:
迷人の笑

图片支持并排,只要不换行。

图片也支持参考式地插入,具体请参考 “链接” 部分。

五、其他


艾特

在论坛里,你可以通过 @ 来艾特一个人。
例如 @Akkariin @Prismaillya
请注意,只能 @ 英文用户名的人,这是因为 Markdown 解析器的 bug 导致的。
Markdown 解析器问题已修复。


自动链接

默认情况下,标准的链接会被自动识别并加上超链接

https://www.natfrp.org/

效果如下

https://www.natfrp.org/


分割线

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

* * *

***

*****

- - -

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

如果在一行文字的下面不空出一行直接写分割线,会将这一行识别为附标题

这几个字会变成 h2
----

效果如下

这几个字会变成 h2

如果分割线是 =,则会变成大标题

这几个字会变成 h1
====

效果如下

这几个字会变成 h1

而如果空了一行出来,那么只会识别成普通文字

感谢阅读,希望这篇教程能对你在论坛发帖有帮助!

zxc7895531 在 2018-11-03 11:41:40 取消置顶了帖子


摸了!

摸了!!!


帖子评分

评分是对作者的一种鼓励,您可以在评论框输入 /cs score 分数 附言 对帖子进行评分。

最少 1 分,最大 5 分,评分会消耗自己的积分,不能给自己的帖子评分。

暂时没有人评分!


发表你的评论

回帖时请注意遵守论坛发言规定,请勿恶意灌水。

  回帖倒序排列   匿名回复 您还可以输入 2000  


欢迎来到 ZeroDream 论坛!

您还没有登录噢 :P

登陆以后就可以发帖和回复啦~


系统主题选项

在线人数:Loading...

WebSocket 状态:Loading...