前言

谁又说不可以呢？

引言

一般论文写作等会有如下痛点，包含：

数学公式
图片处理
交叉引用、脚注、尾注
参考文献的文献库处理

当然大名鼎鼎的Microsoft Office当然能处理这些问题，但是与其说是能处理，不如说是处理的不当就会变得麻烦起来。在这些方面处理的最好的应该是LaTeX，但是由于其语法学习曲线非常陡峭，那么支持部分LaTeX特性的Markdown将是比较好的选择，处理得当时将包含如下特性：

基于自然语言的数学公式处理
HTML支持，意味着markdown的写作可以很灵活多变
插件扩展的的流程图、甘特图、美人鱼图支持
交叉引用、脚注、尾注、文献自动插入
目录自动生成

那么本文将简要的介绍下如何使用markdown来进行基本的写作。

注：本文内容相对较多，但是请相信看完之后收获会是巨大的。

语法

Markdown基础

请不要把markdown视为非常可怕的东西。其实它非常容易掌握，而且对于使用者很友好——因为你在写作时的思路不会被打断，所有格式使用的语法非常简洁并全部可以通过一些文本实现。

在使用之前，为了方便书写请确保你的输入法是处于半角状态（搜狗上是月牙和圆点，月牙为半角；微软拼音在设置里调整），使用半角输入会将你的输入速度无论是在是用什么都会提高一个等级。

标题类

Markdown的标题很容易表示：

1
2
3


# 这是一级标题
## 这时二级标题
### 这是三级标题

每多一级标题就可以增加一个“#”。具体支持到哪级目录需要看渲染工具的支持，理论上无限。

注意：为了使格式生效请在“#”后记得加个空格

标注类

文本上的标注

1
2
3
4


*斜体*			
**加粗**
***加粗的斜体***
<u>下划线</u>

当然你也可以使用下划线替换“*”，效果是一样的。

文内引用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


代码：
​```你的代码语言
echo helloworld;
​```

脚注：
这是一段实例文字。[^1]
[^1]: 这是实例文字的脚注，在生成的Word文档中会自动放置

尾注：
这是一段实例文字。[@example P33 Weearc]
Reference:
(自动生成，不需要动它)

下标：
~下标~

段落引用：
> 你要引用的段落

说明：引用完成时请多加一个回车（换行符），引用时尖括号后需要空格

以上是Markdown的基础语法部分，和普通六级专八词汇相比应该是简单的不是一星半点吧。

链接类

图片

1

![图片的说明](图片位置)

链接

1

![链接的说明文字](链接)

markdown进阶

表格类

基本表格（不含单元格合并）

基本的一个三乘三表格

1
2
3
4


|title1|title2|title3|
|:-----|:----:|-----:|
|左侧对齐|居中|右侧对齐|
|x|y|z|

生成效果如下：

title1	title2	title3
左侧对齐	居中	右侧对齐
x	y	z

HTML表格（包含单元格合并的）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


<table>
    <tr>
        <td>列一</td> 
        <td>列二</td> 
   </tr>
   <tr>
        <td colspan="2">合并行</td>    
   </tr>
   <tr>
        <td>列一</td> 
        <td>列二</td> 
   </tr>
    <tr>
        <td rowspan="2">合并列</td>    
        <td >行二列二</td>  
    </tr>
    <tr>
        <td >行三列二</td>  
    </tr>
</table>

效果：

列一	列二
合并行
列一	列二
合并列	行二列二
合并列	行三列二

公式类

此节主要包含数学公式，使用LaTeX数学公式语法。

上标

1
2
3


$
x^n
$

生成为：$x^n$

下标

1
2
3


$
C^2_3
$

选择数： $C^2_3$

多项式

一个不包含tag的多项式

1
2
3
4
5
6


$
T(n)=\begin{cases}
\Theta(1)\quad n=1\\
T(n-q)+\Theta(n) \quad n>1
\end{cases}
$

那么生成的公式如下：

$T(n)=\begin{cases} \Theta(1)\quad n=1\ T(n-q)+\Theta(n) \quad n>1 \end{cases}$

矩阵及行列式

一个包含tag的矩阵[@noauthor_markdown_nodate-1]

1
2
3
4
5
6
7


$
 \begin{bmatrix}
   1 & 2 & 3 \\
   4 & 5 & 6 \\
   7 & 8 & 9
  \end{bmatrix} \tag{1}
$

$$ \begin{bmatrix} 1 & 2 & 3 \ 4 & 5 & 6 \ 7 & 8 & 9 \ \end{bmatrix} \tag{1} $$

公式

1
2
3


$
J(\theta) = \frac{1}{2m}\sum_{i=0}^m(y^i - h_\theta(x^i))^2
$

生成的均方差公式为：

$J(\theta) = \frac{1}{2m}\sum_{i=0}^m(y^i - h_\theta(x^i))^2$

还有很多…

LaTeX的数学公式异常灵活，其余语法可以自行查阅。

信息类

YAML样式的信息

1
2
3
4
5


---
title: 这是一个标题
time: 2019
TOC: true
---

那么将生成自动目录以及包含时间信息的文章标题部分。

XML样式信息

如果你更熟悉XML，直接上吧骚年！

导图类

使用markdown可以通过公式方式扩展来写流程图等。[@noauthor_typora__nodate]

甘特图(时序图)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


​```mermaid
  sequenceDiagram
    participant 张三
    participant 李四
    张三->王五: 王五你好吗？
    loop 健康检查
        王五->王五: 与疾病战斗
    end
    Note right of 王五: 合理 食物 <br/>看医生...
    李四-->>张三: 很好!
    王五->李四: 你怎么样?
    李四-->王五: 很好!
​```

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24



%% 时序图例子,-> 直线，-->虚线，->>实线箭头

  sequenceDiagram

    participant 张三

    participant 李四

    张三->王五: 王五你好吗？

    loop 健康检查

        王五->王五: 与疾病战斗

    end

    Note right of 王五: 合理 食物 <br/>看医生...

    李四-->>张三: 很好!

    王五->李四: 你怎么样?

    李四-->王五: 很好!

美人鱼图

一个示例的美人鱼图：

1
2
3
4
5
6
7
8
9


​```mermaid
graph TD
client1-->|read / write|SVN((SVN server))
client2-->|read only|SVN
client3-->|read / write|SVN
client4-->|read only|SVN
client5(...)-->SVN
SVN---|store the data|sharedrive
​```

1
2
3
4
5
6
7


graph TD
client1-->|read / write|SVN((SVN server))
client2-->|read only|SVN
client3-->|read / write|SVN
client4-->|read only|SVN
client5(...)-->SVN
SVN---|store the data|sharedrive

此处参考

与文献管理工具互动

为什么不推荐使用word自带的文献管理器，因为Zotero以及Mandelay等文献管理器更加强大而且易用，包含比如PDF阅读、文献检索、文献关联设置、关键词等。

这里只对zotero文献管理器与markdown论文撰写的互动进行说明。

Zotero

首先到Zotero官网下载软件本体进行安装，然后按照提示安装浏览器插件。使用如下图：

（gif）

之后你可以在Zotero导出参考文献。导出时请选择Bibtex格式。需要生成参考文献时直接将导出的文件用文本编辑器打开并进行如下操作：

1
2
3
4
5


#一个实例的bib文件内容
@misc{noauthor_britains_nodate,
        title = {Britain’s imperial fantasies have given us {Brexit} {\textbar} {Gary} {Younge} {\textbar} {Opinion} {\textbar} {The} {Guardian}},
        url = {https://www.theguardian.com/commentisfree/2018/feb/03/imperial-fantasies-brexit-theresa-may},
        urldate = {2019-04-29}

1

这里引用了参考[@noauthor_britains_nodate]

即将包含“@misc”行行首大括号后内容前加“@”用中括号“[]”包裹放在需要引用的位置。生成文件时会自动在文末添加参考文献。[@noauthor_markdown_nodate]

使用pandoc生成（最后一步了）

pandoc安装

Windows

Windows用户可以再官网下载EXE文件进行安装，并安装Python3使用pip安装pandoc的其他扩展。

Mac OS

Mac用户可以使用brew来安装pandoc，并使用pip来添加扩展

Linux

重点说一下Linux，以证明使用Linux同样可以撰写论文。

大多数Linux发行版的仓库内包含pandoc，并默认有pip。使用pip可安装扩展。

对于Arch Linux

Arch Linux仓库中为pandoc以及LaTeX全部扩展进行了打包，直接安装，舒适便捷。

生成方式

在此文中，我们需要使用的插件为：pandoc-citeproc。

那么使用如下指令生成：

1

pandoc --filter pandoc-citeproc --bibliography=你的文献库.bib --csl=chinese-gb7714-2005-numeric.csl  你的markdown文件.md -o  你的生成文件.docx

其中“–csl”选项为需要生成参考文献的具体格式标准。

如果你单单只使用：

1

pandoc  markdown文件.md -o  生成的文件

将只进行最基础的文件渲染，比如转换为PDF格式。

参考文献（示例）

https://baike.baidu.com/item/markdown/3245829?fr=aladdin markdown ↩︎
https://zh.wikipedia.org/wiki/Pandoc Pandoc ↩︎
https://baike.baidu.com/item/%E5%AF%8C%E6%96%87%E6%9C%AC%E6%A0%BC%E5%BC%8F/1017816?fr=aladdin 富文本格式 ↩︎

使用pandoc撰写论文

前言

引言

相关概念

Markdown

markdown编辑器推荐

Typora（全平台）

Mu（Mac OS）

Atom 或者 Visual Studio Code（全平台）

pandoc

富文本

语法