0%

Markdown 指南-latex 公式-Typora-Pandoc

概述

Markdown:一种轻量级纯文本标记语言

  • 简单、易用:语法标准而简单易学习。
  • 纯文本、跨平台:轻量的纯文本内容的标记性语言,兼容所有的文本编辑器与文字处理软件。
  • 干净整齐,排版良好,可读性高。
  • 专注内容而不是排版,轻松导出 HTML、PDF 和本身的 .md 文件。

markdown 基本语法

标题

1
2
3
4
5
# 一级标题

## 二级标题

### 三级标题

字体

斜体

粗体

删除线

~~删除文本~~删除文本

H2O

x^2^

==高亮==

content in paragraph with footnote^1 markup.

1
2
3
4
5
6
斜体:一级强调:_斜体_
粗体:二级强调:**粗体**
~~删除文本~~
H~2~O
x^2^
==高亮==

块结构

引用

引用,块注释

双层引用

1
2
3
> 引用,块注释
>
> > 双层引用

代码

行内代码

1
2
3
4
5
6
`行内代码`

代码块:指定语法高亮
`python print("Hello World!") ​`

或前置四个空格,

列表

  • 无序列表 1
  • 无序列表 2
  1. 有序列表
  2. 有序列表
1
2
3
4
5
6
7
-+\*均可,但-最方便

- 无序列表 1
- 无序列表 2

1. 有序列表
2. 有序列表

复选框

使用 - [ ]- [x] 语法可以创建复选框,实现 todo-list 等功能。例如:

  • 已完成事项
  • 待办事项 1
  • 待办事项 2
1
2
3
- [x] 已完成事项
- [ ] 待办事项 1
- [ ] 待办事项 2

表格

标题标题标题
居左测试文本居中测试文本居右测试文本
居左测试文本 1居中测试文本 2居右测试文本 3
居左测试文本 11居中测试文本 22居右测试文本 33
居左测试文本 111居中测试文本 222居右测试文本 333
1
2
3
4
5
6
| 标题             |       标题       |             标题 |
| :--------------- | :--------------: | ---------------: |
| 居左测试文本 | 居中测试文本 | 居右测试文本 |
| 居左测试文本 1 | 居中测试文本 2 | 居右测试文本 3 |
| 居左测试文本 11 | 居中测试文本 22 | 居右测试文本 33 |
| 居左测试文本 111 | 居中测试文本 222 | 居右测试文本 333 |

链接

百度

1
[百度](http://www.baidu.com “相关说明,可为 None”)

图片

1
2
![图片名](http://图片地址)
![Alt text](/path/to/img.jpg "Optional title")

分割线


1
2
3
4
5
6
7
以下三者均可,推荐 ---

---

## updated: 2022-04-04 14:35:02

+++

目录

1
[toc]

脚注(footnote)

hello^1

1
2
hello[^1]
[^1]: hi

建议

  • 列表、分割线等 - + * 通用的地方建议统一使用 -,因为它只需按一个键
  • 尽量少用五级标题和六级标题,使用有序列表和无序列表代替

LaTeX 公式

LaReX:For 数学公式,

公式:equation:$ a+b=c$,此时表现为数学模式,所有的字母表示为分离的变量,字母的间距会变大

行内公式:inline equation,一些简单的公式,可以放在行内,如 $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$。

行间公式:displayed equation,如求和、求积分较大或内容较复杂,不适合放在行间

函数名,需罗马正体,采用反斜杠 + 函数名来实现。比如 \sin,\cos,\log,\ln。

算子,如 \lim,\max、\min、\gcd 等。

  • 简单的多个公式堆积:
    • gather:公式居中
    • align:可用 & 符号指定位置对齐,如按等号对齐。

$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \
\end{vmatrix}
$$

1
2
3
4
5
6
7
$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$

运算

  • 加减:\pm $\pm$
  • 乘:\times $\times$
  • 除:\div $\div$
  • 点乘:\cdot $\cdot$
  • 小于等于:\leq $\leq$
  • 大于等于: \geq $\geq$
  • 不等于:\neq $\neq$
  • 约等于:\approx $\approx$
  • 恒等于:\equiv $\equiv$
  • 空格:\quad $a \quad b$
  • 两空格:\qquad $a \qquad b$
  • 大空格:a\ b $a \ b$
  • 中空格:a \; b $a;b$
  • 小空格:\, $a,b$

上下标

  • 下标:x_2 $x_2$
  • 上标:x^2 $x^2$
  • 向量 Vectors: \vec{a} $\vec {a}$
  • 度:37^{\circ} $37^{\circ}$
  • 上划线:\overline{aa} $\overline{m+n}$
  • 下划线:\underline{aa} $\underline{m+n}$
  • 下方大括号 \underbrace{a+b+\cdots+z}_{26} $\underbrace{a+b+\cdots+z}_{26}$
  • 上方大括号 \overbrace{a+b+\cdots+z}^{26} $\overbrace{a+b+\cdots+z}^{26}$
  • 分数 fraction:\frac{}{} $\frac{1}{2}$
  • 根式:\sqrt{x}:$\sqrt{x}$
    • \sqrt [3]{2} $\sqrt[3] {2}$
  • 尖:\hat{x} $\hat {x}$

高等数学

  • 行列式: \begin{vmatrix} 1&2&3\\4&5&6\end{vmatrix} $\begin{vmatrix} 1&2&3\4&5&6\end{vmatrix}$
  • 矩阵:\begin{bmatrix} 1&2&3\\4&5&6 \end{bmatrix} $\begin{bmatrix} 1&2&3\4&5&6 \end{bmatrix}$
    • \begin{matrix} 1&2&3\\4&5&6 \end{matrix} $\begin{matrix} 1&2&3\4&5&6 \end{matrix}$
    • matrix:无
    • bmatrix:方括号
    • vmatrix:竖线
    • pmatrix:圆括号
    • Bmatrix:花括号
    • Vmatrix:双竖线
  • 大括号:\begin{Bmatrix} y_1&=&ax_1+bx_2 \\ y_2&=&cx_1+dx_2\end{Bmatrix} $\begin{Bmatrix} y_1&=&ax_1+bx_2 \ y_2&=&cx_1+dx_2\end{Bmatrix}$
  • 属于:\in $\in$
  • 求和 sum: \sum_{i=1}^{n} $\sum_{i=1}^{n}$
  • 积分 integral: \int_{0}^{\frac{\pi}{2}} $\int_{0}^{\frac{\pi}{2}} $
  • 乘积 product:\prod $\prod_ \epsilon$
  • 模:\left \| x \right \| $\left | x \right |$ $||x||$
  • 求偏导:\partial L(x,y) $\partial L(x,y)$
  • 普朗克常数,\hbar
  • 无穷符号,\infty
  • 空集符号,\emptyset(也可以调用 amssymb 宏包后使用 \varnothing)
  • 偏微分符号,\partial
  • 积分符号,\int,\iint,\iiint,\iiiint,分别对应一重、二重、三重、四重积分;更多重积分可以用 \idotsint
  • 环路积分符号,\oint
  • 求和符号,\sum
  • 求积符号,\prod
  • 交集符号,\cap;并集符号,\cup
  • 乘号,\times;除号,\div $\times$$ \div$
  • 不等号,\neq;小于等于,\leq;大于等于,\geq;$\neq \leq \geq$
  • 属于,\in,$\in$

括号

集合

higher order roots:\sqrt[3]{2} $\sqrt[3]{2}$

root sign:\surd[x+y] $\surd[x+y]$

factions:\frac{a+b}{a-\frac{a}{b}} $\frac{a+b}{a-\frac{a}{b}}$

force large(display)faction:\dfrac{a+b}{a-\dfrac{a}{b}}$\dfrac{a+b}{a-\dfrac{a}{b}}$

continued fraction:1+\cfrac{2}{3+\cfrac{4}{5+\cfrac{6}{7+\dotsb}}}=\frac{1}{\sqrt{e}-1}

$1+\cfrac{2}{3+\cfrac{4}{5+\cfrac{6}{7+\dotsb}}}=\frac{1}{\sqrt{e}-1}$

binomal:\binom{n+1}{k} $\binom{n+1}{k}$

prime:y''+y'=y $y’’+y’=y$

希腊字母

说明:-:需连读为一个音节

  • 阿尔法:\alpha $\alpha$
  • 贝塔、比特:\beta $\beta$
  • 伽马:\gamma $\gamma$
    • \Gamma $\Gamma$
  • 德尔特:\delta $\delta$
    • \Delta $\Delta$
  • 诶普西龙:\epsilon $\epsilon$
    • \varepsilon $\varepsilon$
  • 日 - 伊塔、日 - 诶塔:\zeta $\zeta$
  • 伊塔:\eta $\eta$
  • 西塔:\theta $\theta$
    • \Theta $\Theta$
  • 爱欧塔、哟塔 \iota$\iota$
  • 卡帕:\kappa $\kappa$
  • 兰 - 布达 \lambda $\lambda$
    • \Lambda $\Lambda$
  • 谬、木:\mu $\mu$
  • 拗、怒:\nu $\nu$
  • 克赛、可 - 西 \xi :$\xi$
  • 欧米克荣:\omicron:$\omicron$
  • 派:\pi:$\pi$
    • \Pi:$\Pi$
  • 楼:\rho $\rho$
  • 西格玛:\sigma $\sigma$
    • \Sigma:$\Sigma$
  • 套、拓:tau:$\tau$
  • 宇普西龙:\upsilon :$\upsilon$
    • \Upsilon:$\Upsilon$
  • 佛 - 爱、佛 - 伊:\phi $\phi$
    • \Phi$\Phi$
  • 恺、可 - 亿:\chi $\chi$
  • 普西、普赛:\psi $\psi$
    • \Psi $\Psi$
  • 欧美伽、欧米伽:\omega $\omega$
    • \Omega$\Omega$
  • \varphi $\varphi$

Typora

设置

1
2
3
4
5
6
7
8
9
10
11
12
13
通用:
自动保存:勾选
编辑器:
即时渲染,显示当前块元素的 Markdown 源码:勾选
图像:
插入图片时:复制图片到 ./${filename}.assets 文件夹
对本地位置的图片应用上述规则:勾选
对网络位置的图片应用上述规则:勾选
优先使用相对路径:勾选
Markdown:
严格模式:勾选
Markdown 扩展语法:全勾选
公式:自动添加序号

快捷键

  • 生成目录:[TOC] 按回车
  • 标题:ctrl+数字
  • 表格: Ctrl + t
  • 无序列表:输入-之后输入空格
  • 有序列表:输入数字+“.”之后输入空格
  • 任务列表:-[空格] 空格 文字
  • 选中单词:ctrl+d
  • 选中相同格式的文字:ctrl+e
  • 搜索:ctrl+f
  • 替换:ctrl+h
  • 引用:输入>之后输入空格
  • 加粗:ctrl+b
  • 倾斜:ctrl+i
  • 下划线:ctrl+u
  • 删除线:alt+shift+5
  • 插入图片:直接拖动到指定位置即可或者ctrl+shift+i
  • 插入链接:ctrl+k
  • 数学公式: Ctrl + Shift + M
  • Ctrl+P:快速速打开

流程图

横向流程图

1
2
3
4
5
6
7
8
```mermaid
graph LR
a -->b
b-->c
c-->|a=1|d[结果 1]
c-->|a=2|E[结果 2]
F
​```
1
2
3
4
5
6
graph LR
a -->b
b-->c
c-->|a=1|d[结果 1]
c-->|a=2|E[结果 2]
F

竖向流程图

1
2
3
4
5
6
7
8
```mermaid
graph TD
A[方形] -->B(圆角)
B --> C{条件 a}
C -->|a=1| D[结果 1]
C -->|a=2| E[结果 2]
F[竖向流程图]
​```
1
2
3
4
5
6
graph TD
A[方形] -->B(圆角)
B --> C{条件 a}
C -->|a=1| D[结果 1]
C -->|a=2| E[结果 2]
F[竖向流程图]

标准流程图

1
2
3
4
5
6
7
8
9
10
11
```flow
st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st->op->cond
cond(yes)->io->e
cond(no)->sub1(right)->op
​```
1
2
3
4
5
6
7
8
9
st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st->op->cond
cond(yes)->io->e
cond(no)->sub1(right)->op
1
2
3
4
5
6
7
8
9
10
11
12
%% 时序图例子,-> 直线,-->虚线,->>实线箭头
sequenceDiagram
participant 原型设计
participant 编码
原型设计 -> 编码:原型设计图
loop 测试
测试-> 测试:单元测试
end
Note right of 测试:通过 <br/> 发布
编码-->> 原型设计:通过
编码-->测试:测试用例
测试->编码:测试报告
1
2
3
4
5
6
7
8
9
10
11
12
%% 时序图例子,-> 直线,-->虚线,->>实线箭头
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
```mermaid
%% 语法示例
gantt
dateFormat YYYY-MM-DD
title 软件开发甘特图
section 设计
需求 :done, des1, 2020-01-06,2020-01-08
原型 :active, des2, 2020-01-09, 3d
UI 设计 : des3, after des2, 5d
未来任务 : des4, after des3, 5d
section 开发
学习准备理解需求 :crit, done, 2020-01-06,24h
设计框架 :crit, done, after des2, 2d
开发 :crit, active, 3d
未来任务 :crit, 5d
耍 :2d
section 测试
功能测试 :active, a1, after des3, 3d
压力测试 :after a1 , 20h
测试报告 : 48h
​```
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
%% 语法示例
gantt
dateFormat YYYY-MM-DD
title 简要甘特图示例
section 设计
需求:done,des1, 2020-01-06,2020-01-08
原型:active,des2, 2020-01-09, 3d
UI 设计:des3, after des2, 5d
未来任务:des4, after des3, 5d
section 开发
学习准备理解需求:crit, done, 2020-01-06,24h
设计框架:crit, done, after des2, 2d
开发:crit, active, 3d
未来任务:crit, 5d
部署:2d
section 测试
功能测试:active, a1, after des3, 3d
压力测试:after a1 , 20h
测试报告:48h

Pandoc

Pandoc:标记式文档格式转换器。可将文档在 Markdown、LaTeX、reStructuredText、HTML、Word docx 等多种标记格式之间相互转换,并支持输出 PDF、EPUB、HTML 幻灯片等多种格式。该程序被称为格式转换界的 “瑞士军刀”。

因文档多采用 Markdown 工具进行编写,而别人不一定有 Typora 这种神器工具来操作 Markdown,故采用 Pandoc 进行相关格式的转换。

下载安装

Pandoc

使用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
pandoc <files> <options>
-f:format:输入格式,默认为 Markdown
-t:输出文件格式,默认为 HTML
-o:输定输出文件,该项缺省时,将输出到标准输出;
--verbost: 显示详细调试信息
--log: 指定输出日志信息
--highlight-style <style>:设置代码高亮主题,默认为 pygments;
-s:生成有头尾的独立文件(HTML,LaTeX,TEI 或 RTF);
-S:聪明模式,根据文件判断其格式;
--self-contained:生成自包含的文件,仅在输出 HTML 文档时有效;
--verbose:开启 Verbose 模式,用于 Debug;
--list-input-formats:列出支持的输入格式;
--list-output-formats:列出支持的输出格式;
--list-extensions:列出支持的 Markdown 扩展方案;
--list-highlight-languages:列出支持代码高亮的编程语言
--list-highlight-styles:列出支持的代码高亮主题;
-v、--version:显示版本信息
-h、--help:显示帮助信息

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 一些例子
# 获取网页内容,并将其转换为 markdown 格式(感觉可以用来写简易爬虫)
pandoc -f html -t markdown http://www.fsf.org

# 将 input.txt 文件作为 markdown 输入,转换为 latex
pandoc -f markdown -t latex input.txt

# 如果未指定-f、-t,pandoc 则会根据输入文件输出文件的后缀来转换
pandoc input.txt -o output.pdf

# pandoc 要求输入输出使用 utf8 编码,可以使用 iconv 命令进行编码转换
iconv -t utf-8 input.txt | pandoc | iconv -f utf-8

# 如果需要使用 tex 生成 pdf 文件,则需要下载 latex 编译器
需要形成独立文件(standalone)的加上 -s 选项
# 需要形成文件而不是命令行输出的加上 -o 指定输出文件名

# markdown 转 html5 独立文件
pandoc -s -o output.html input.md

# markdown 转 latex
pandoc -f markdown -t latex -o hello.tex hello.txt

# markdown 转 reveal.js html
pandoc -s -t revealjs slides.md

转 html

1
2
3
pandoc demo.md -o demo.html
pandoc demo.md -c style.css -o demo.html #引入 css,但要传 html 文件与 css 文件
pandoc demo.md --self-contained -c style.css -o demo.html#将文件嵌入到 html

转 docx

1
2
pandoc demo.md -o demo.docx
pandoc http://gnss.help/2017/06/12/pandoc-install-usage/ -o this_page.docx #网页转 doc

转 pdf

使用 Pandoc 直接生成 PDF 文件时,需要安装 LaTeX。并且,Pandoc 自带的 PDF 引擎不支持中文,必须为中文配置额外的引擎和模板。

我生成 PDF 文档时,未使用以上的方法。而是采用 HTML 文件作为中间文件过渡,使用 Windows 系统的 “打印到 PDF” 功能,将 HTML 文档进一步转换为所需的 PDF 文档。

1
pandoc demo.md -o demo.pdf

相关命令

1
2
3
pandoc --list-input-formats #查看程序支持的输入文件格式
pandoc --list-highlight-language #查看程序支持代码高亮的编程语言
pandoc --help #查看程序帮助

附 有趣的符号

★☆

👍

↖↗↘↙↓↑←→

附 希腊字母表

序号大写小写英语音标注音英文汉语名称常用指代意义
1Αα/‘ælfə/alpha阿尔法角度、系数、角加速度、第一个、电离度、转化率
2Ββ/‘bi:tə/ 或 /‘beɪtə/beta贝塔磁通系数、角度、系数
3Γγ/‘gæmə/gamma伽玛电导系数、角度、比热容比
4Δδ/‘deltə/delta得尔塔变化量、焓变、熵变、屈光度、一元二次方程中的判别式、化学位移
5Εε/‘epsɪlɒn/epsilon艾普西隆对数之基数、介电常数、电容率
6Ζζ/‘zi:tə/zeta泽塔系数、方位角、阻抗、相对黏度
7Ηη/‘i:tə/eta伊塔迟滞系数、机械效率
8Θθ/‘θi:tə/theta西塔温度、角度
9Ιι/aɪ’əʊtə/iota约 (yāo) 塔微小、一点
10Κκ/‘kæpə/kappa卡帕介质常数、绝热指数
11λ/‘læmdə/lambda拉姆达波长、体积、导热系数 普朗克常数
12Μμ/mju:/mu磁导率、微、动摩擦系(因)数、流体动力黏度、货币单位,莫比乌斯函数
13Νν/nju:/nu磁阻系数、流体运动粘度、光波频率、化学计量数
14Ξξ希腊 /ksi/英美 /ˈzaɪ/ 或 /ˈsaɪ/xi克西随机变量、(小)区间内的一个未知特定值
15Οο/əuˈmaikrən/或 /ˈɑmɪˌkrɑn/omicron奥米克戎高阶无穷小函数
16π/paɪ/pi圆周率、π(n) 表示不大于 n 的质数个数、连乘
17Ρρ/rəʊ/rho电阻率、柱坐标和极坐标中的极径、密度、曲率半径
18σ,ς/‘sɪɡmə/sigma西格马总和、表面密度、跨导、正应力、电导率
19Ττ/tɔ:/ 或 /taʊ/tau时间常数、切应力、2π(两倍圆周率)
20Υυ/ˈipsɪlon/或 /ˈʌpsɪlɒn/upsilon宇普西龙位移
21Φφ/faɪ/phi磁通量、电通量、角、透镜焦度、热流量、电势、直径、空集,欧拉函数
22Χχ/kaɪ/chi统计学中有卡方 (χ^2) 分布
23Ψψ/psaɪ/psi普西角速、介质电通量、ψ 函数、磁链
24Ωω/‘əʊmɪɡə/或 /oʊ’meɡə/omega奥米伽欧姆、角速度、角频率、交流电的电角度、化学中的质量分数、不饱和度
给博主来一杯卡布奇诺