Markdown语法小记

本文主要涉及Typora编辑器的markdown语法，可能与其他编辑器稍有差异。

Typora 采用标准为 GitHub Flavored Markdown 。详情参阅 官方参考文档

Markdown

公式

想用公式一定要在front-matter里开启 math: true 啊！！血的教训！！！

公式编号及引用

Edge浏览器公式显示有问题（加 \tag{} 时），暂时未解决，最好改用Chrome。

typora的自动编号功能不是很好用，

• 有些公式不想编号，不知道如何去掉编号；
• 不知道如何更改编号样式，只能 (1) (2)... 不能 (1.1) (2.2)...

我暂时没有找到解决办法， 官方文档 也没有给出明确解答。

行间公式

$$
y=sin(x) \label{first} \tag{1.1}
\text{, 在这可加文字}
$$

\[ y=sin(x) \label{first} \tag{1.1} \text{, 在这可加文字} \]

引用公式（含括号） \(\eqref{first}\)

`$\eqref{first}$`

引用公式（不含括号） \(\ref{first}\)

`$\ref{first}$`

注意，引用公式时公式内必须加 \label{} 及 \tag{} 。

特殊字符

希腊字母

\delta	\(\delta\)
\Delta	\(\Delta\)

更多 详见

链接

markdown插入链接 Shixin

[Shixin](https://babblingme.gitee.io)

可如果链接中包含()该如何处理？ Plasma(physics)

[Plasma(physics)](https://en.wikipedia.org/wiki/Plasma_(physics))

这样最后一个右括号 ) 会露在外边，解决办法：

• 将链接转换到底部

  第二行代码不会显示在网页中 Plasma(physics)

  [Plasma(physics)][1]
  [1]:https://en.wikipedia.org/wiki/Plasma_(physics) 可以在这里添加标题

脚注

这里是脚注，语法为 <sup id="fnref:1" class="footnote-ref"><a href="#fn:1" rel="footnote"><span class="hint--top hint--rounded" aria-label=" 。 ">1<sup id="fnref:1" class="footnote-ref"><a href="#fn:1" rel="footnote"><span class="hint--top hint--rounded" aria-label=" 。 ">1

HTML

HTML语法教程可参见 这里 。

字体

两种方法，字体大小不太一致

• HTML

  <font color="blue">示例</font>

  示例

• \(LaTeX\)

  $\color{blue}{好吧}$ 

  \(\color{blue}{好吧}\)

空格

markdown中段首直接用空格键输入空格是无效的（在网页中不显示），可以采用如下几种方式

• 全角空格（推荐）

  一般输入法切换全角模式为 Shift+空格 ，微软自带输入法按了没反应，是没开快捷键，可查看 这里 设置。

  　　切换为全角模式之后直接按两个空格就是两个汉字的宽度。

• 手动全角空格  

    这里使用了2个 ，不要漏掉分号；em意思可以参见 这里

• 手动半角空格   （不建议）

          这里使用了8个 ，同样不要漏掉分号；

缩写

2020年是哈尔滨工业大学（<abbr title="Harbin Institute of Technology">HIT</abbr>）建校100周年。

2020年是哈尔滨工业大学（HIT）建校100周年。

对齐

• 右对齐

  <p align="right">哈尔滨工业大学</p>

  哈尔滨工业大学

• 居中

  <center>建校100周年庆</center>

  建校100周年庆

便签

可通过以下两种方式加入便签

• HTML（普适）

  <p class="note note-info">这里是primary便签，不支持`markdown`</p>

  这里是primary便签，不支持markdown

• 特定代码（需要添加此功能）

  {% note warning %}
  这里是warning便签，支持`markdown`
  {% endnote %}

  这里是warning便签，支持markdown

其他可选便签 详见 。

锚点

两种方法，在markdown中不能跳转，但到网页中就可以了

• markdown

  [这里链接到便签](#便签)

  这里链接到便签

• HTML

  <a href="#便签">这里也链接到便签</a>

  这里也链接到便签

注意两点（以上两种方法都是）

• 不管几级标题都用一个 # ，如上示例

• 锚点跳转目标中如有空格或英文点号 . ，要替换成 - ，如下锚点目标

  ### 1.1 哈工大校史

  锚点语法应该为

  [示例](#1-1-哈工大校史)

  <a href="#1-1-哈工大校史">示例</a>

折叠块

<details>
    <summary>点击查看</summary>
    这里是隐藏的内容。<br/>
    暂时不支持markdown, latex。
    主题开发者说会考虑支持，坐等。
</details>

点击查看

这里是隐藏的内容。
暂时不支持markdown, latex。 主题开发者说会考虑支持，坐等。

Typora

快捷键

详见 官方文档

自定义快捷键

Ctrl+, → 通用 → 打开高级设置 → conf.user.json → Custom key binding

添加自定义快捷键即可，如下

// Custom key binding, which will override the default ones.
"keyBinding": {
  // for example: 
  // "Always on Top": "Ctrl+Shift+P"
  "刷新所有数学公式": "F5"
},

注意，只有在菜单栏中有的功能才可以设置快捷键，且不论中英文，内容必须与菜单栏中内容一致。添加完成后重启typora，就会在菜单栏中看到原先没有快捷键功能有了你设定的快捷键。

持 续 更 新 中 ， 嘤 嘤 嘤 . . .

1. 这里是脚注内容，语法为 <a href="#fnref:1" rev="footnote" class="footnote-backref"> ↩︎</a></span></span></li><li><span id="fn:1" class="footnote-text"><span> 。 ↩︎