文本编辑指南

为何需要本指南

我们经常需要书写教程、题解等。因而必须学习文本、公式编辑的技术。

由于绝大部分网页无法支持 word / pdf 格式的内容,而 html 过于繁杂,故需要使用本站及大部分网站所支持的带有 mathjax 公式插件的 markdown 格式。

一个编辑器

请在电脑端安装 typora 软件。

第一次使用时,请单击工具栏“文件”->“偏好设置”,在 markdown 设置模块中勾选“内联公式”。

您需要学习的

百度 markdown 和 \LaTeX 。并在 typora 中利用前二者的格式编辑您的文本。

由于很多人抗拒百度,因此我不得不写下相关的教程。如果您已经熟知这些东西,请跳过即可。

markdown

0.换行

按Shift+回车是单行距换行,效果如下:

行1
行2

按回车是双行距换行,效果如下:

行1

行2

需要注意的是,对于单行距换行,一定要在一行最后加两个空格。

1.标题

在typora中输入以下内容:

1
2
3
4
5
6
# 一级标题
## 二级
### 三级
#### 四级
##### 五级
###### 六级

显示效果:

(此处为一级标题,因为一级标题会影响渲染,故不显示,大家自行脑补)

二级

三级

四级

五级
六级

需要注意:绝对不允许在 MO Wiki 中使用一级标题!!!

2.引用

在typora中输入以下内容:

1
> XXX

XXX

这便是引用。需要注意,在typora中,按一次换行会出现这种效果:

XXX

这时,必须再按一次换行才能跳出引用区。

事实上,在typora输入:

1
2
3
4
5
> xxx
xxx
233

233

效果如下:

xxx xxx 233

233

3.插入图片、超链接

在typora中输入 [XXX](某网址) ,会显示为XXX,点进去就可以转到相应网址。

在typora中输入 ![这里面随便填](图片网址) ,就能显示出这个图片。

需要注意的是,切不可在typora中直接粘贴图片,或者引用本地图片。必须使用无水印图床(例如路过图床)上传图片。这时候,网页上会出现一个图片。下面一堆链接不用管。然后用下面的方式获取这个图片的地址。

在浏览器中,右键某个网页的图片,选择“复制图片地址”即可。

4.其他格式

输入

1
2
**233**  
~~233~~

233
233

5.无序列表

在typora中输入如下内容:

1
2
3
4
5
6
7
8
- XXX
YYYYYY  //行末有2个空格
YYYYYY
- XXX
    - YYY
    - YYY
    666  //行末2空格
- ee
  • XXX YYYYYY
    YYYYYY
  • XXX
    • YYY
    • YYY 666 //行末2空格
  • ee

6.文本区

在typora中输入

1
2
3
4
5
​```text
XXXXXXXX      //此时换行行末不需要有空格!
asd~~233~~
**233**
​```

效果:

1
2
3
XXXXXXXX
asd~~233~~
**233**

事实上,你在文本框输入什么,显示出来就是什么。文本框里的内容不会经过markdown渲染。

在typora中,如果你编辑到了文本框的末尾,可以按Ctrl+回车跳出文本框。

对于行内嵌套的文本框,输入如下:

1
这是行内文本框:`XXXXXXXXXXXXX`

显示为:

这是行内文本框:XXXXXXXXXXXXX

7.插入 LaTeX 公式

在typora中输入 这是行内公式:$\sqrt2$ ,会显示为:

这是行内公式:\sqrt2

输入:

1
2
3
4
5
//这里需要有空行
$$
\sqrt2   //这里写 LaTeX 代码
$$
//这里需要有空行

效果: $$ \sqrt2 $$

\LaTeX

参考:https://blog.csdn.net/happyday_d/article/details/83715440

纠正:矩阵应该是:

$\begin{pmatrix}X&X&X\\X&X&X\\X&X&X\end{pmatrix}$

\begin{pmatrix}X&X&X\\X&X&X\\X&X&X\end{pmatrix}

LaTeX 的格式规范:https://oi-wiki.org/intro/htc/#latex

编辑规范

  • 请遵循 LaTeX 的格式规范。

  • 所有数学符号、常数、作为变量的字母应使用 LaTeX 公式。

  • 中文与英文字符或公式之间以一个空格隔开,但中文标点符号与英文字符或公式之间不应有空格
  • 请勿滥用 LaTeX 公式。不是公式的内容不应当使用 LaTeX。比如 $MO Wiki$是一个Wiki 就是典型的错误用法。应当改为 MO Wiki是一个Wiki
  • 请务必确保您的文档中引用的 外链 图片的链接有效。
  • 请确保您的文档中的引用链接的稳定性, 不推荐 引用 自建 服务(如 OJ)中的资源(如题目)。
  • 站内链接请去掉网站域名,并且使用相对路径链接对应 .md 文件。如:在本页面( intro/latex )中链接「帮助我们编辑页面」( htc ),应使用 [帮助我们编辑页面](../htc.md)
  • 添加例题时,题目必须使用「站内独有的格式」第一种
  • 写例题题解,题解必须使用「站内独有的格式」第二种

内容规范

  • 内容必须前后有逻辑,不可遗漏过多知识点。
  • 应当有讲解,不应该通篇除了讲题啥都没有。
  • 需要包含例题。每个知识点十分简单的例题不能超过1道。除了非常简单的例题以外,例题的题解应当包含解题思路和套路总结,就是说:这个题怎么想到的;以后遇到 XX 题型,可以尝试用 XX 方法;这是怎样一种重要的思考方式,日后应该养成。
  • 如果做到上面一点有困难,应当说明,比如「遗憾的是,本题的辅助线及其巧妙,没有什么明确的理由可言」,比如「本题最容易想到的应该是 XX 法,因此用这里的方法其实没有什么特别的道理」。

站内独有的格式(在typora不会显示)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
???+note "标题"
    内容         //行末有两个空格
    多行内容

??? note "标题"  //默认折叠
    内容         //行末有两个空格
    多行内容

!!! warning "标题"
    内容         //行末有两个空格
    多行内容

效果:

标题

内容
多行内容

标题

内容
多行内容

标题

内容
多行内容

评论