MarkdownSyntax

[TOC]

表格中打出br

Shift + Enter

html 图片自加超链接 链接图片自身

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

<a href="www.yourdomain.com" target="_blank">
<img src="/i/eg_buttonnext.gif" width="675" height="900" border="0" />
</a>
choe: 将热点文字 替换为 图片即可

# beautify
<a href="/path/imageName.png" target="_blank">
<img src="/path/imageName.png" width="675" height="900" border="0" />
</a>

# oneline version for copy
<a href="/path/imageName.png" target="_blank"><img src="/path/imageName.png" width="675" height="900" border="0" /></a>

mermaid docs

markdown绘图插件—-mermaid简介

Setext

标题1

标题2

空格,空行和Tab在Mark是分隔的作用。空格的个数也是关键的.

Atx

1

2

3

4
5
6

#换行
行末尾加个2+个空格

引用 ^>+1空格 表示引用,内部可以嵌套多个引用

段落引用1
段落引用2

段落引用嵌套
嵌套引用

无序列表 +,-, * +1Backspace

  • b
  • a
  • c
  • item1
  • item2
  • item1
  • itme2

有序列表 数字+英文名号+1Backspace

  1. item1
  2. item2
  3. item3

code

行内代码 反斜杠` (esc 下的那个键)
代码段落 靠格式缩进控制 ^4Blankspace 或 ^Tab

bash>$echo "haha"

root#ll
root#fdisk
root#df -h

强调 星号* or 下划线_

1星 = 斜体
2星 = 加粗

1_ = _斜体_
2_ = 加粗

link

inline or Refrence
inline: [linkname](http_url_href “optional title”)
refrence:用于解决 多处需要引用同一个URL.
语法:调用部分[link_name][ref]
定义部分 [ref]: http://wwww.xxx.com/url 可选的标题
tip: ref中不区分大小写
inline_url
[refrence_url][my_ref]
[my_ref]: http://91kuaile.cn

picture

markdown 不支持调整 图像的位置 align,可以利用 html tag image来实现。

Markdown doesn’t allow you to tweak alignment directly (see docs here: http://daringfireball.net/projects/markdown/syntax#img), but you can just use a raw HTML ‘img’ tag and do the alignment with inline css.

Unabridged version

The Markdown syntax doesn’t provide one with the ability to control the position of an image.

In fact, it would be borderline against the Markdown philosophy to allow such formatting, as stated in the “Philosophy” section

“A Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions. “

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
This works just fine: <img align="..." src="..." alt="...">

<p align="center">
<img />
</p>

didn't worked to me in GitHub. <p align="center"><img src="image" /></p> nor <p style="align:center"><img src="image" /></p>


Original markdown processes markdown syntax within span tags. So some thing like the following should work:
<span style="display:block;text-align:center">![Test Automation]Automated-Testing.png)</span>


<img src="url" alt="alt text" width="whatever" height="whatever">
<a href="https://your-image-url.type"><img src="https://your-image-url.type" width="100" height="100"/></a>


<div style="text-align:center"><img src="..." /></div>

与link比较相似, 区别是中括号前加!, !不能控制图片大小(可以考虑html \<img>)

Inline示例:![替代文本](/assets/images/jian.jpg “可选的title”)
Reference示例:![替代文本][pic]
[pic]: /assets/images/ship.jpg “可选的title”
HTML示例:\替代文本

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<table style="width:100%">
<tr>
<th> 1 </th>
<th>2 </th>
<th>3</th>
</tr>
<tr>
<td>
<img src="photo20190523.assets/image-20190523113956315.png" align="left" width="200"/>
</td>
<td>
<img src="photo20190523.assets/image-20190523113956315.png" align="right" width="200"/>
</td>
<td>comment</td>
</tr>
</table>

image-20190523151040567

自动链接

使用尖括号,可以为输入的URL或者邮箱自动创建链接 xcuiwm@hotmail.com http://91kuaile.cn

Asset Folders

_config.yml
post_asset_folder: true
下一行格式下:>+1Tab,不加Tab,是不行的,还加一个空行。

{% asset_path slug %}
图片显示:\{% asset_img slug [title] %}
下载连接:\{% asset_link slug [title] %}

{% asset_img example.jpg This is an example image %}
{% asset_img "spaced asset.jpg" "spaced title" %}

tips: 前面有2+空格时,导致不起作用

分隔线

3+{*,_,-}, 其中可以有空格但不能有其它字符

转义字符 \

需要转义的字符:

  • 反斜杠 \
  • 反引号 `
  • 星号 *
  • 下划线_
  • 大括号{}
  • 中括号[]
  • 小括号()
  • 标题符号#
  • 序号+
  • 序号-
  • 序号.
  • 叹号!

如何让 MarkDown 不解析某些内容?
引用:
ref1.
github语法教程
Markdown语法教程

Hexo下的Markdown语法(GFM)写博客