Typecho Markdown 语法大全 - 如何排版出优美的文章

小助手读文章 00:00 / 00:00

Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。Markdown 的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的 HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。

一、字句

1、粗体/斜体

Markdown 的粗体和斜体也非常简单,用两个 包含一段文本就是粗体的语法,用一个 包含一段文本就是斜体的语法。

语法

这是**粗体**这是*斜体*

效果

这是粗体这是斜体

2、高亮

有两种方式,一种是用 < code > 包住,一种使用 `` 包住。

语法

高亮

效果

第一种第二种

二、段落

1、标题

标题是每篇文章都需要也是最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加 # 号即可,总共六级标题,建议在井号后加一个空格,这是最标准的 Markdown 语法,同时建议标题后换行,编写时可读性更高。

语法

# 一级标题
## 二级标题
### 三级标题

效果

标题

注:有些主题(比如本站主题)通过识别该符号来实现目录导航功能。

2、列表

熟悉 HTML 的同学肯定知道有序列表与无序列表的区别,在 Markdown 下,列表的显示只需要在文字前加上 - 或 * 即可变为无序列表,有序列表则直接在文字前加 1.2.3. 符号要和文字之间加上一个字符的空格。

语法

- 无序列表
* 无序列表
1. 有序列表
2. 有序列表

效果

列表

3、引用

如果你需要引用一小段别处的句子,那么就要用引用的格式,在 Markdown 里只需要在文本前加入 > 这种尖括号(大于号)即可。

语法

> 这里是引用

要注意符号和文本间的空格

效果

引用

4、分割线

分割线的语法只需要另起一行,连续输入三个星号 *- 即可。

语法

//-需上空一行
---
//*无需空一行
***

效果



5、层级

层级通过 + 号实现,注意空格。

语法

+ 第一级
 + 第二级
  + 第三级

效果

  • 第一级

    • 第二级

      • 第三级

注:层级前的符号可以通过 css 改变。

三、高级排版

1、图片与链接

插入链接与插入图片的语法很像,区别在一个 !号,插入图片的地址是 URL 地址,可以使用自带编辑器上传图片获得 URL,或者上传至图床获得 URL。

语法

[Baidu](http:/ /baidu.com)
![图片说明](http:/ /mouapp.com/Mou_128.png)

也可以这样写:

[Baidu][ 5 ]
![图片说明][ 6 ]

[ 5 ]:http:/ /baidu.com
[ 6 ]:http:/ /mouapp.com/Mou_128.png

效果

图片

2、表格

表格是我觉得 Markdown 比较累人的地方,例子如下(注意文字对齐方式):

语法

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

效果

TablesAreCool
col 3 isright-aligned$1600
col 2 iscentered$12
zebra stripesare neat$1

注:表格宽度等排版可通过 css 控制。

3、代码框

如果你是个程序猿,需要在文章里优雅的引用代码框,在 Markdown 下实现也非常简单,只需要用两个`把中间的代码包裹起来,如果引用了某些语法高亮插件,还可以添加特定标识。

语法

代码

效果

我是代码,这里的任何输入都将原样输出

4、不处理

有时候我们正常的文字表达中出现了 Markdown 标记,但实际上是不希望被标记解析的,这时候我们可以通过反斜杠 \ 来声明。

语法

1\.这不是列表
1.这是列表

效果

1. 这不是列表

  1. 这是列表

5、注脚

如果有引用内容,并且想直接关联,那么可以使用注脚(或脚注)来表示。

语法

引用内容[^引用自 vircloud.net]

效果

引用内容[注1]

注:不是所有 Markdown 编辑器都支持,并且显示方式也未必都一样。

Typecho 默认编辑器的 Markdown 语法基本就是这样子,你学会了吗?


附:Markdown 和常见的富文本编辑器有什么区别?

如果只输入不带任何格式的文字,无需任何复杂的工具。正是为了赋予文字不同的「外貌」(即格式或者样式),我们才需要文字编辑器。例如输入的文字属于纯文本(即不带格式),而给文字标记上的颜色则属于文字的样式。对于用户来说,Markdown 编辑器和富文本编辑器(例如 Word )的作用是一致的:使用者输入纯文字,通过编辑器的处理,使其拥有一份样式,最终得到带格式的文档。
然而这两者的差距,就在处理文字的过程中,富文本编辑器以 Word 为例,输入文字后,选择不同的功能(通常是通过点击某个图标),例如加粗或者调整字体大小,处理后的效果直接显示在屏幕上,与打印出来的效果相同。所以富文本编辑器又叫「所见即所得」编辑器。
而 Markdown 编辑器则不同,输入文字后通常是在文字的前后同时输入一些标记字符,输入后在编辑窗口也不会即时的显示出效果,需要手动切换进预览模式查看处理效果,因为这些标记字符的存在,所以 Markdown 本身是一种标记语言。

注:本站启用了语法高亮,因此部分标记实际显示效果可能会有差异。


参考文章:
1、《Markdown 中文版语法说明
2、《Markdown: Syntax
3、《认识与入门 Markdown
4、《Markdown 完全入门(上)


参考资料:

  1. 引用自 vircloud.net

ArmxMod for Typecho
个性化、自适应、功能强大的响应式主题

推广

 继续浏览关于 教程typechomarkdown语法排版编辑 的文章

 本文最后更新于 2019/10/16 14:15:38,可能因经年累月而与现状有所差异

 引用转载请注明: VirCloud's Blog > 系统 > Typecho Markdown 语法大全 - 如何排版出优美的文章

精选评论

  1. LEO
    LEO 回复

    Windows 7Chrome 79.0.3945.117来自 广东 的大神

    可以转载吗?
    觉得非常有用。
    像收藏一下。
    谢谢

    1. 欧文斯

      可以,请使用评论时的 IP 访问 https://vircloud.net/action/share/1267.md 复制文章 MarkDown 源码。

  2. LEO
    LEO 回复

    Windows 7Chrome 79.0.3945.117来自 广东 的大神

    我也要转载。 谢谢

    1. 欧文斯

      请使用评论时的 IP 访问 https://vircloud.net/action/share/1267.md 复制文章 MarkDown 源码。

  3. 爆锤南瓜头
    爆锤南瓜头 回复

    LinuxChrome 80.0.3987.122来自 贵州 的大神

    icon_mrgreen.gif

  4. 道客
    道客 回复

    Windows 7Chrome 80.0.3987.163来自 河北 的大神

    我也想转载,但估计不是那么容易的,里面的格式直接复制肯定不行的。
    想想还是算了,有空来这里学习吧!

    1. 欧文斯

      可以的,使用评论时的 IP 访问 https://vircloud.net/action/share/1267.md,排版都帮你排好了 icon_mrgreen.gif

  5. 森木志
    森木志 回复

    Android 10Chrome 83.0.4103.83来自 广东 的大神

    icon_mrgreen.gif 我也要下载研究下

    1. 欧文斯

      可以的,使用评论时的 IP 访问 https://vircloud.net/action/share/1267.md,排版都帮你排好了

  6. 朝花
    朝花 回复

    Windows 10Chrome 115.0.0.0来自 四川 的大神

    厉害啊大佬