Markdown Basic Grammar
Markdown is a “HTML”-like tag language, What you see is what you get, just follow some basic rules and you get beautiful page. This is a cheatsheet and simple demonstration of Markdown as my first blog on HEXO.
Headers
# H1
or:
H1-prime
======
## H2
or:
H2-prime
------
### H3
###### H6
效果:
H1
or:
H1-prime
H2
or:
H2-prime
H3
H6
Compared to html:
<h1/> H1
<h2/> H2
...
<h5/> H5
H1
H2
…
H5
Emphasis
斜体、加粗、斜体加粗、划去效果:
*italics* or _italics_
**bold** or __bold__
**combine or _combine_**
~~Scratch.~~
效果:
italics or italics
bold or bold
combine or combineScratch.
大纲式列表
1. 第一点(识别机制:“任意数字 + . + 半角空格”)
2. 第二点
10. 第三点
..* 打点子列
4. 第四点 第一段
...第二段
* Unordered list can use asterisks
- Or minuses
+ Or pluses
插入URL 和 图片
URL: some text 如:[B站](https://www.bilibili.com)
B站
Image: 如:![alt text](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Title Text 1")
鼠标在图片上悬停看title:
Compared to html
<a ref = "https://www.bilibili.com">B站</a>
<img src="https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png">Logo Title Text 1</img>
B站
Logo Title Text 1
代码块
行内代码用单引号 code
:
Inline code
is here.
整块代码用三个引号, 注释语言显示语法高亮:
```javascript
var s = "JavaScript syntax highlighting";
alert(s);
s = "Python syntax highlighting"
print s
No language indicated, so no syntax highlighting.
But let's throw in a <b>tag</b>.
```javascript
var s = "JavaScript syntax highlighting";
alert(s);
s = "Python syntax highlighting"
print s
No language indicated, so no syntax highlighting.
But let's throw in a <b>tag</b>.
水平分隔符
三个以上的 ‘-‘, ‘*’ 或者 ‘_’
A
---
B
***
C
___
D
*****
效果:
A
B
C
D
LaTex 公式
在写这篇blog之前,本来以为只要在公式两头加 $ 或者 $$ 符号就搞定了,没想到在 Hexo 中渲染 LaTex 公式并不容易,
Hexo 中 LaTex 公式异常的主要原因是 Markdowm 和 Latex 的语法冲突(参考这篇博客),这个问题得不到很好的解决,不能像 Jupyter Notebook 里一样直接在 Markdown 中间插入 Latex 都没问题。
解决方法:
- 有一些 hexo 主题本身支持 Mathjax 插件,比如我使用的 material 主题,只需要在博客中指定开启这个插件就解决了;
… 默认的 landscape 主题的 Mathjax 原本有 BUG 但可能现在已经修复了:
… landscape 的官方说明: - 如果主题不支持这个插件的话,要安裝 hexo-math :
npm install hexo-math --save
。如果仍然渲染失败的话,手动在 html 文件里面加入 mathjax 的 JavaScript
真心希望 hexo 更新的时候可以内置支持…
渲染测试:(失败)
$$\frac{\partial ^2 \varphi}{\partial x^2}$$
$$\sigma \Sigma$$
行内公式:$\varphi=\frac{Q}{4\pi \epsilon\_0 r}$
效果:
$$\frac{\partial ^2 \varphi}{\partial x^2}$$
$$\sigma \Sigma$$
行内公式:$\varphi=\frac{Q}{4\pi \epsilon_0 r}$
参考
https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet