Markdown入门笔记(针对Typora编辑器)

简介

Markdown是一门轻量级标记语言,它使用简洁的语法代替排版,使我们专心于码字.

它使用简洁的字符标记来达到office/Word中的各种字体/段落等手动设置.由于每个人在使用Word时的文本设置各不相同,就算同一个人,在不同的文档中可能使用的设置方式都不同,就造成了文本的格式和外观千奇百怪.这不利于传播和阅读.

使用Markdown语法来创造内容如记录笔记,写网络博客等各种文档则要方便的多,除了最开始入门时需要记住常规的Markdown标记语法之外,使用Markdown语法写出的文档外观十分优雅简洁,看起来令人赏心悦目.再也不用在Word中每次都手动设置各种字体段落格式了,以后自己记录的所有文档都只有一种格式。这点对于经常在win10和linux系统来回切换的同学十分重要。

Markdown常用语法

标题/Header

在标题前面加上1-6个#,表示一级标题,二级标题...六级标题(#和标题内容之间至少一个空格符隔开):

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

输出效果:


一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

列表/Lists

Markdown支持有序列表和无序列表.

无序列表使用*或者-或者+作为列表标记:

* Red
* Green
* Blue

- Red
- Green
- Blue

+ Red
+ Green
+ Blue

输出效果:

  • Red
  • Green
  • Blue

有序列表使用数字+英文句点来表示:

markdown
1. Red
2. Green
3. Blue

输出效果:

  1. Red
  2. Green
  3. Blue

强调/Emphasis

两个*或者-表示加粗,一个*或者-表示斜体,~~表示删除:

**加粗文本**或者__加粗文本__
*斜体文本*或者_斜体文本_
~~删除文本~~

输出效果:


加粗文本或者加粗文本

斜体文本或者斜体文本

删除文本


链接/Links

链接语法可掌握常见的2种:标准式自动链接

标准式链接: [百度主页](https://www.baidu.com)
自动链接:直接用`<>`括起来<https://www.google.com>

输出效果:


标准式链接: 百度主页
自动链接:直接用<>括起来https://www.google.com


图片/Images

图片和链接的语法很像,区别在于图片比链接多了一个!.基本格式:

图片: ![]()        ![图片文本(可以忽略不写)](图片地址)

实际插入图片时,常用的有两种情况:插入本地图片插入网页图片

插入网页图片时,()中输入的是图片的网页链接地址:

网页图片: 
![简书](https://ss3.bdstatic.com/70cFv8Sh_Q1YnxGkpoWK1HF6hhy/it/u=762703104,3048150584&fm=27&gp=0.jpg)

输出效果:

网页图片: 
简书

插入一张本地图片时,找到菜单栏的编辑->图片工具->插入本地图片

以上两种方法达到的效果完全一样,此时,图片格式的()中记录的是插入的本地图片的绝对路径.

另外,在文件->偏好设置->编辑器->图片插入处:

Screenshot from 2018-03-09 11-11-22.png

如果勾选优先使用相对路径,在此文档已经保存的前提下,图片格式中的()则记录的是以本文档所在文件夹问根目录的相对路径.

此外,在勾选了允许复制图片到指定文件夹选项的前提下,选择编辑->图片工具->当插入本地图片时->拷贝到文件夹...,此时选择图像拷贝的目标文件夹d-folder

此后,每当使用前面插入本地图片的命令时,程序会自动复制原图片到d-folder文件夹,而且,图片格式中的()里面记录的是d-folder文件夹中图片的绝对路径.

所以,所有的图片都要先保存到本地硬盘,之后才可以进行插入操作.

无论以上哪一种方式,请记住:因为Markdown文件只是一个纯文本文件,图片格式中记录的只是获取图片的路径,当硬盘中的图片被删除或者被移动之后(或者将.md文件复制到别人的电脑上),.md文件中的所有插入的图片都将失效,显示不出来了.

这一点和Word的直接截屏->复制到剪切板->粘贴到Word相比,确实是一个短板,因为Word文件不是纯文本文件,它可以包含图像数据.

所以,为了防止以上图像失效的情况,最好是每次写完一个Markdown文档,就将其导出成PDF或者HTML格式,作为备份.

代码

插入代码的功能可能是Markdown文档最好用的功能之一了.

回想在Word中插入一段代码是什么效果?且不说语法高亮消失,显示效果也是十分丑陋.而在Markdown文档中插入代码的显示效果则几乎接近于专业的代码编辑器了,这一点使得Markdown文档用来写编程类的技术文档相当方便.

代码格式分为2类:

  • 行内代码,或者说成小代码块,适用于在某一行中插入一小句代码.
  • 代码块,当插入一段代码时,使用代码块语法.
行内代码使用` `标识,比如`cv2.namedWindow('image')`
代码块使用``` ```标识,比如:
​

输出效果:
cv2.namedWindow('image')

while(1):
    cv2.imshow('image', img)
    k = cv2.waitKey(1)
    if k==27:
        break
    r = cv2.getTrackbarPos('R', 'image')
    b = cv2.getTrackbarPos('B', 'image')
    g = cv2.getTrackbarPos('G', 'image')
    s = cv2.getTrackbarPos(switch, 'image')
    
    if s==0:
        img[:] = 0
    else:
        img[:] = [b, g, r]
cv2.destroyAllWindows()

分割线

使用三个*生成分割线:

***

输出效果:


参考文章:Typora For Markdown 语法

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

推荐阅读更多精彩内容

  • 关于Markdown 一整个学期下来,我觉得让我收获最大之一的是学会markdown语言。我们平常都是使用Word...
    Dacade阅读 936评论 0 2
  • 为什么学习Markdown 自从搭建了 Hexo 博客之后,发现还有 Markdown 这种写文章的方法,想到以后...
    lifeColder阅读 20,150评论 10 217
  • 暗恋是一个人的兵荒马乱! 三月,草长莺飞,百花齐放,明媚的有点忧伤,趁我未老,趁青春犹在,纪念下我那逝去的兵荒马乱...
    二毛的忧伤阅读 165评论 0 0
  • 鞋子是我们的良师益友 总是 陪伴着我们生活 鞋子陪着我们 走过荆棘和泥泞 使双脚不再受到伤害 鞋子陪伴着我们 走过...
    毛虫苑李博晶阅读 247评论 0 0
  • “单点上的极致突破往往能改变全局,没有取舍的结果必然导致全面平庸。” 一、打造爆款:店铺明星产品 1.导入期: 产...
    奔跑的双双双菇凉阅读 573评论 0 1