WordPress下jetpack中的markdown与公式写法

WordPress的JetPack是个好东西,只是可惜在墙外,如果服务器在国内的话,那么JetPack这个好东西就很难用上了。JetPack直接提供了Markdown语法和Latex公式支持,给使用外部编辑器带来了很大的方便。虽然Markdown语法基本大同小异,不过JetPack所支持的还是有点轻微的不同的,下面就整理了一下JetPack的Markdown与Latex公式使用方法。

一、基本文本

1.1 正文文本

正常方式书写就是正文文本,开头不能出现半角空格(但是可以使用全角空格来实现开头空两格)。注意正常文本中不要使用< >这样的标签,因为会被解释成HTML,这样就没有办法显示了。如果真的需要使用这样的标签,那么最好使用行内代码的格式来实现。

一般情况下,MarkDown使用空行进行分段,不能进行换行(换行符会被忽略)。而JetPack的Markdown则可以使用回车符换行,而空行依旧可以分段,这一点有所不同。

正文文本样式示例:

这是一个基本文本,
回车符可以实现换行效果

用空行实现分段

1.2 标题

#实现标题格式,#的数量代表级别(注意#后面要加空格,上方要空行)。

正文文本样式示例:

# 一级标题

## 二级标题

### 三极标题

1.3 格式化文本

格式化文本是什么呢?实际就是”所见即所得的文本”,也就是说,你输入了什么样子,显示的时候就是什么样子。这在很多时候非常有用(比如说使用文本画图)。

格式化文本只需要在普通的文本每行前面加上两个空格即可。

1.4 加粗和斜体

加粗和斜体可以使用两种符号*(星号)和_(下划线),两种符号均可单独实现加粗和斜体。必须注意的是,*_所包含的内容的前后是不能加空格的。

左右一个符号 = 加粗,左右两个符号 = 斜体

加粗    **粗体**  __粗体__
斜体    *斜体* _斜体_
不能加空格,如:  ** 粗体**

显然,加粗和斜体在代码和格式化文本中是没有办法使用的。

1.5 代码格式

代码格式分为两种,一种是行内代码,使用\行内代码`来实现,而另外一种则行间代码,使用下面形式实现,其中cpp`代表代码高亮样式,如果没有的话,即采用纯文本的样式,没有高亮。

```cpp
#<include> iostream;
using namespace std;
int main(){
    retunr 0;
}
```

效果:

#<include> iostream;
using namespace std;
int main(){
    retunr 0;
}

二、列表

列表可使用的标记有*,数字.-,实现效果有所不同。

2.1 标点列表

使用*_作为开头的标点式列表,注意行前不能有空格,符号后要有一个空格。整个列表前后要空行,而列表中间不能空行。

范例:

* 标点列表1
* 标点列表2
- 标点列表3
- 标点列表4

效果:

  • 标点列表1
  • 标点列表2
  • 标点列表3
  • 标点列表4

2.2 数字列表

有些时候我们需要数字列表,规则是数字.的形式。注意行前不能有空格,符号后要有一个空格。整个列表前后要空行,而列表中间不能空行。

数字列表比较特别的地方就是,数字本身并不重要,只需要是这个数字即可,因为排序是自动的。如果列表中间出现换行,那么就数字就会重新排序。想要换行插入代码而数字且不会重新排序,参阅2.3节混合列表。

范例:

1. 标点列表1
1. 标点列表2
1. 标点列表3
1. 标点列表4

效果:

  1. 标点列表1
  2. 标点列表2
  3. 标点列表3
  4. 标点列表4

2.3 混合列表

有些时候我们需要混合列表,即列表中再套一个列表。这个时候只需要在内嵌的列表中前面加上两个空格即可。

范例:

1. 标点列表1
1. 标点列表2
  * 内嵌列表1
  * 内嵌列表2
1. 标点列表3
1. 标点列表4

效果:

  1. 标点列表1
  2. 标点列表2
    • 内嵌列表1
    • 内嵌列表2
  3. 标点列表3
  4. 标点列表4

如果想要在列表插入数行的代码之类的,也是同样的方案,只需要在代码的前面加入两个空格即可。

三、链接与说明

3.1 超链接

将文本变成超链接的形式,可以点击跳转。方案有两种。第一种方案是直接使用下面格式:

[点击跳转](http://example.com "Title")

其中Title可以去掉,并没有实际用处。

第二种方案则是使用参考格式,将链接与正文部分分开了,如下格式:

[点击跳转][1]
[1]: http://example.com/ "Title"

第二方式似乎从markdown角度来说更好看一点,不过两者效果是完全一致的。

3.2 插入图片

插入图片的方式和插入链接的方式一致,同样有两种方式:

![Alt](http://example.png "Title")

![Alt][1]
[1]:http://example.png "Title"

图片默认情况下会直接采用默认大小,过大的的情况下会适配文本宽度,这点必须要注意。想要精确调整图片的位置的大小,需要HTML代码,单纯的markdown做不到。

3.3 脚注

markdown同样支持脚注,方法与插入图片的第二种方式类似。在文本使用[^数字]的形式,而文尾使用[^相同数字]:进行注释。例如:

文本[^1],是很有用的
[^1]: 这是文本的注释

注意,解释是必须在文尾,同时两者必须要匹配上才会显示,否则,文中是不会显示的。

3.4 缩写解释

在文后使用*[缩写]:这种情况下解释缩写的含义。如:

Markdown converts text to HTML
*[HTML]: HyperText Markup Language

3.5 定义列表

使用下面的形式即可使用定义列表:

WordPress
: A semantic personal publishing platform

四、公式的写法

wordpress的公式是利Latex写出来的,支持的宏有如下三个:

  • amsmath
  • amsfonts
  • amsymb

目前一般只用写公式。

4.1 基本用法

只需要将公式内容包含在

$ latex LATEX公式内容$
(去除$与latex的空格,因为该语句在任意情况均生效,不得已而为之)

中即可。例如:

$ latex i\hbar\frac{\partial}{\partial t}\left|\Psi(t)\right>=H\left|\Psi(t)\right>$

效果:

i\hbar\frac{\partial}{\partial t}\left|\Psi(t)\right>=H\left|\Psi(t)\right>

必须注意的是,格式化文本和公式中依旧可以生效。

4.2 更改字体大小

默认的latex公式字体较小,很多时候需要调整一下字体大小。只需要在Latex代码后加入&s=数字即可。其中数字可以选择-4~4,0代表正常大小,数字越大,字体越大,反之则反。如:

$ latex i\hbar\frac{\partial}{\partial t}\left|\Psi(t)\right>=H\left|\Psi(t)\right>&s=3$

效果:

i\hbar\frac{\partial}{\partial t}\left|\Psi(t)\right>=H\left|\Psi(t)\right>

4.3 更改字体颜色

wordpress的Latex支持前景色和背景色的,只需要在代码后加入&bg=颜色代码&fg=颜色代码来修改前景色和背景色,颜色代码自然指的是css颜色编码,如ffffff代表白色。例如:

$ latex \LaTeX&bg=ffcccc&fg=cc00ff&s=4$

效果:

\LaTeX

显然,直接使用编辑器来编辑公式是很容易出错的,这个时候可以使用在线latex编辑工具来编辑好相应的公式,然后将latex代码复制过来即可。此处推荐一个挺好用的latex在线编辑器:http://latex.codecogs.com/eqneditor/editor.php?lang=zh-cn

Reference

1.Markdown quick reference
2.LaTeX.Wordpress.com

此条目发表在LINUX分类目录,贴了, 标签。将固定链接加入收藏夹。

发表评论

电子邮件地址不会被公开。