Markdown使用教程

作者:朱文滨

时间:2018-03-25

最近发现一款很好的Markdown编辑器,Typora!之前一直使用word文档编辑,后面发现word文档样式并不能符合我的要求,所以在网站搜索了一番,最后发现了它!下面让我们开始简单使用它吧。

块级元素

段落和换行

如果需要另起段落,直接按下Enter键,也就是换行,也可以在文字末尾加上<br/>即可。

标题

Markdown支持6级的标题,对应HTML的h1~h6,比如:

#一级标题,在文字前面加上一个#号
##二级标题,在文字前面加上两个#号
依次类推
...

文本引用

在文字前面加上 > 即可,比如:

作者:朱文滨

时间:2018-03-25

>作者:朱文滨
 时间:2018-03-25

列表

无序列表

在文字前面加上 * 然后空一格即可,比如:

  • 红色

  • 绿色

  • 蓝色

* 红色
* 绿色
* 蓝色

有序列表

在文字前面加上 1. 然后空一格即可,比如:

  1. 红色
  2. 绿色
  3. 蓝色
1. 红色
2. 绿色
3. 蓝色

任务列表

在文字前面加上 - 然后空一格即可,如果需要序号在后面加上 **[x] **比如:

  • [1] 起床
  • [2] 刷牙
  • [3] 吃早餐
- [1] 起床
- [2] 刷牙
- [3] 吃早餐

代码块

在文字前面加上 ``` 按下回车键即可,如果需要针对不同的代码做显示优化,在按下 ``` 的同时敲入java、html等字符,编辑器会做相应的显示优化,比如:

public class Hello {
    
    public static void main(String[] args) {
        System.out.println("Hello, world.");
    }
}

数学表达式

支持Tex/LaTex 语法,输入 $$ 按下回车键即可,比如:
$$
\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}
$$

$$
\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}
$$

表格

| 隔开,输入列内容即可,比如:

电话号码 名称
10000 中国电信
10010 中国联通
10086 中国移动
| 电话号码 | 名称     |
| -------- | -------- |
| 10000    | 中国电信 |
| 10010    | 中国联通 |
| 10086    | 中国移动 |

脚注

脚注是在需要标记脚注文字的后面增加一个方括号,方括号中的内容必须以 ^ 开头,再接着是数字、字符串标记:

这是一篇关于Markdown的使用教程[^1]

接着,在文件的任意地方,可以把这个脚注的内容定义出来。脚注内容定义的形式就是前面引用脚注的内容,接着一个冒号,再接着一个以上的空格或制表符,最后是脚注定义的内容:

[^1]: 使用Typora编辑器

比如:

这是一篇关于Markdown的使用教程[1]

横线

输入 *** 或者 --- 按下回车键即可,比如:


目录

输入 [toc] 按下回车键即可自动生成文档目录,比如:

[TOC]

内联元素

内联

以中括号[]标记显示的链接文本,后面紧跟用小括号()包围的链接。如果链接 Title 属性,则在链接中使用空格加"Title 属性",即[Title](URL "Title"),比如:

开源中国

[开源中国](https://www.oschina.net/)

引用

一般应用于多个不同位置使用相同链接。通常分为两个部分:

调用部分格式为:[链接文本][ref]

*注:两个中括号之间可以有空格。

定义部分可以出现在文本中的其他位置,格式为:[ref]: http://some/link/address (可选的标题)

比如:

开源中国

[开源中国][oschina]

[oschina]: https://www.oschina.net

链接

使用尖括号<>,可以为输入的URL或者邮箱自动创建链接,如开源中国

https://www.oschina.net

图片

添加图片的使用方法基本上和链接类似,只是在中括号前加叹号!,即[图片上传失败...(image-bf7301-1521983788279)],比如:

GitHub Mark
![GitHub Mark](http://github.global.ssl.fastly.net/images/modules/logos_page/GitHub-Mark.png "GitHub Mark")

注:Markdown 不能设置图片大小,如果必须设置则应使用HTML标记 <img>*

斜体

使用 * 或者 _ 包含内容即可,等同于HTML的 <em> 标签,比如:

这是一段斜体文字

*这是一段斜体文字*

加粗

使用 ** 或者 __ 包含内容即可,等同于HTML的 <strong> 标签,比如:

这是一段加粗的文字

**这是一段加粗的文字**

代码

使用 ` 包含内容即可,比如:

System.out.println("Hello, world.");

`System.out.println(Hello, world.);`

删除线

使用 ~~ 包含内容即可,比如:

这是一段被删除的文字

~~这是一段被删除的文字~~

下划线

使用 <u></u> 包含内容即可,比如:

<u>这是一段有下划线的文字</u>

<u>这是一段有下划线的文字</u>

表情

先输入 : 然后输入相应的表情英文,再输入 : 即可,比如:

:smile:

:smile:

上标

要想使用上标、下标、高亮等功能,首先在偏好设置里启用相应的功能。

1521982617173.png

启用相应的功能后,输入 ^ 包含的文字即可,比如:

X2

X^2^

下标

要想使用上标、下标、高亮等功能,首先在偏好设置里启用相应的功能。

1521982617173.png

启用相应的功能后,输入 ~ 包含的文字即可,比如:

X2

X~2~

高亮

要想使用上标、下标、高亮等功能,首先在偏好设置里启用相应的功能。

1521982617173.png

启用相应的功能后,输入 == 包含的文字即可,比如:

==这是一段高亮的文字==

==这是一段高亮的文字==

总结

一些Markdown写作的好习惯:

  • 英文字母与中文之间需要两边空格(英文与符号之间不空格)
  • 高亮英文之间需要两边空格
  • 代码符号 上面需要空一行,结束 下面需要空一行
  • 中文之间和短英文之间使用中文标点
  • 一篇文章中只能出现一个 # 号标题

  1. 使用Typora编辑器

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,496评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,407评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,632评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,180评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,198评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,165评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,052评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,910评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,324评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,542评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,711评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,424评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,017评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,668评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,823评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,722评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,611评论 2 353

推荐阅读更多精彩内容

  • 🎉🎉🔔主题:第九次锦囊会议-项目管理&清单制作🔔 🌟承办组:9组🌟 ⏰时间:周日 3月25日 6:00-7:30 ...
    闻宣阅读 313评论 0 0
  • 上一篇文章为:→1.4Linux命令概述 Linux命令-文件、磁盘管理 1.文件管理 <1>查看文件信息:ls ...
    lyh165阅读 542评论 1 0
  • 【班会时间】 3月25日(周日)6:30-7:30 【班会地点】 云之家GP20期班级群 【参会人员】 所...
    倍儿棒_阅读 494评论 0 1
  • 我妈拿着刀追着我爸跑。当时我正和她在一起,收到消息后只是强装镇定,跟她说家里有点事,然后匆忙离开。
    麻烦面阅读 300评论 0 1
  • 最近总是看到一些鸡汤文里说,愿你能被世界温柔以待。可是我们不能寄希望于这个世界对自己温柔以待,因为这个世界始终都是...
    北蔺阅读 383评论 0 1