Markdown Basic Grammar

Author Avatar
akimoto-cris 12月 26, 2017

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 combine
Scratch.

大纲式列表

1. 第一点(识别机制:“任意数字 + . + 半角空格”)
2. 第二点
10. 第三点
..* 打点子列
4. 第四点 第一段
...第二段

* Unordered list can use asterisks
- Or minuses
+ Or pluses

插入URL 和 图片

URL: some text 如:[B站](https://www.bilibili.com)
B站

Image: some text 如:![alt text](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Title Text 1")
鼠标在图片上悬停看title:
alt text

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 都没问题。

解决方法:

  1. 有一些 hexo 主题本身支持 Mathjax 插件,比如我使用的 material 主题,只需要在博客中指定开启这个插件就解决了;
    … 默认的 landscape 主题的 Mathjax 原本有 BUG 但可能现在已经修复了:
    … landscape 的官方说明:
  2. 如果主题不支持这个插件的话,要安裝 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