Markdown的简单上手教程

背景

一直以来都是使用的word和各种文本编辑器,我的习惯一般都是摘取各部分的信息然后糅杂在一块,所以后期整理一直是我一大头疼的地方,直到我接触了markdown之后,才发现,原来排版可以如此轻松写意且优美自然!

原因

其实作为一个程序员来说,我是相当不合格的,常常不会太想接触新鲜的知识,总是想着够用即可,Markdown是我求变的第一步,所以,做一个简单的笔记吧,相信以后的路也会更好。

笔记

其实markdown的宗旨是为了让编写作者摆脱排版的烦扰而专注于写作本身,原理其实就是实现了一个便捷的转HTML标签的途径,所以,如果你了解过HTML语言的话,学起Markdown来应该是轻车熟路,但是Markdown也提供了很多优秀的基于js的实现,比如你可以很方便的写出数学公式和时序图、流程图等,好了,应用是检验真理的唯一标准,上手学习并练习下吧。


1.文本基础

这里是一大块的,只要记住下面这张表格,然后自己上手练习下即可。

内容 表示 说明
斜体 *斜体*或者_斜体_ 就是<em>标签,推荐使用*来表示斜体
粗体 **粗体**或者__粗体__ 就是<strong>标签,依然推荐使用*来表示,比较直观
删除线 ~~删除线~~ 就是<s>标签
标题 #或者##~###### 或者 标题下面添加---为一级,===为二级 推荐使用#~######,就是<h1>~<h6>
引用 使用>来表示引用 类似HTML中的<q>或者<blockquote>,不过Markdown的格式更漂亮,如果要在引用里面嵌套引用,只需要多个>即可
代码 行内代码使用`来表示,多行代码使用```来表示 分别对应HTML中的<code><span>,还可以在多行代码的```css后面添加代码的说明,如加上css等表示代码的品种
无序列表 * - +都可以表示无序列表 对应<ul>标签,表示多层列表,只要第二层缩进4个空格即可
有序列表 1. 2. 或者 1. * 对应<ol>标签,表示多层列表,只要第二层缩进4个空格即可
超链接 [链接](地址 "说明") 相当于<a href="地址" title="说明">链接</>
图片 !+[图片失败说明](地址 "说明") 相当于img src="地址" title="说明" alt="图片失败说明"
引用 图片和超链接可以使用引用,先定义变量[变量]: 地址 "说明",然后引用 [链接][变量],然后 就相当于[链接](地址 "说明")
目录 使用[toc]就可以在当前位置插入一个目录 这些目录是根据标题生成的
脚注 [^变量]: 脚注说明,然后在需要用到脚注的地方[^变量]引用即可 遵循先定义后使用的原则,可以参考引用

2.表格

表格其实在Markdown里面的表示算麻烦的,不过好像确实也没有想出其它比较好的实现方式
使用|来抽象的表示表格的框,使用:来进行对齐设置
这是一个表格的源码

|内容居左|内容居中|内容居右|
|:----|:----:|----:|
|A|A|A|
|B|B|B|

表现形式如下

内容居左 内容居中 内容居右
A A A
B B B

3.时序图

Markdown中的时序图和流程图的写法是我比价喜欢的,又可以扔掉一些复杂且重量级的工具了
你需要做的就是在```后面添加sequence来表示这段代码是一个时序图即可!
直接上代码,简书好像不支持时序图和流程图,想验证的可以上CSDN博客去

title: 时序图例子
A->B: 实线实箭头
B-->C: 虚线实箭头
C->>C: 实线虚箭头
note right of C: 自通知
note over B,C:横跨通知
C->A:长通知
note left of A:左通知

显示:

时序图.png

4.流程图

流程图跟时序图差不多,遵循先定义再写流程图即可,掌握四种表示类型:start,end,condition,operation
你需要做的就是在```后面添加flow来表示这段代码是一个流程图即可!
上代码:

start=>start: 开始
isLogin=>condition: 是否登录
login=>operation: 登录
view=>operation: 浏览
end=>end: 结束

start->isLogin
isLogin(no)->login->view
isLogin(yes)->view
view->end

显示:

流程图.png

0408更新
学习了Markdown的流程图之后,总觉得少点什么,但是百度之后的各种介绍文章也都大同小异,于是直接找上了老外的github地址 flowchart.js,Markdown的流程图就是基于这个开源的js实现的,奈何实在是英文水平有限,又懒的看js内部的各种火星文,偷瞄了一眼作者在example 中的例子,发现了不少新东西,于是明白了一个道理,学东西都要学源头的,看国内文章都是管中窥豹,不能学的全部
OK,以下结合这个例子来说明下:

st=>start: Start|past:>http://www.google.com[blank]
e=>end: End:>http://www.google.com
op1=>operation: My Operation|past
op2=>operation: Stuff|current
sub1=>subroutine: My Subroutine|invalid
cond=>condition: Yesor No?|approved:>http://www.google.com
c2=>condition: Good idea|rejected
io=>inputoutput: catch something...|request

st->op1(right)->cond
cond(yes, right)->c2
cond(no)->sub1(left)->op1
c2(yes)->io->e
c2(no)->op2->e

上面的这段Markdown流程图代码可以看做是一种进阶版流程图

type类型由原来的四种增加到了六种,这六种分别是

  • start 表示开始,以椭圆形表示
  • condition 表示条件,以菱形四边形表示
  • operation 表示操作,以矩形形表示
  • subroutine 表示子程序,以三格矩形表示,这个就是多任务分支的一种形式
  • inputoutput 表示输入输出流,以平行四边形形表示
  • end 表示结束,以椭圆形表示

然后各个类型的type都可以用()来表示流程的走向

  • right 向右
  • left 向左
  • up 向上
  • down 向下,这个是默认选项

元素样式:使用| type来表示,目前有七种样式

  • 'past' : { 'fill' : '#CCCCCC', 'font-size' : 12},
  • 'current' : {'fill' : 'yellow', 'font-color' : 'red', 'font-weight' : 'bold'},
  • 'future' : { 'fill' : '#FFFF99'},
  • 'request' : { 'fill' : 'blue'},
  • 'invalid': {'fill' : '#444444'},* 'approved' : { 'fill' : '#58C4A3', 'font-size' : 12, 'yes-text' : 'APPROVED', 'no-text' : 'n/a' },
  • 'rejected' : { 'fill' : '#C45879', 'font-size' : 12, 'yes-text' : 'n/a', 'no-text' : 'REJECTED' }

**使用:>地址[打开方式]来跟流块内的文字绑上链接,打开方式跟HTML中一致,如下: **

  • _blank -- 在新窗口中打开链接
  • _parent -- 在父窗体中打开链接
  • _self -- 在当前窗体打开链接,此为默认值
  • _top -- 在当前窗体打开链接,并替换当前的整个窗体(框架页)

__ ** 这个是实现效果,快上手试试吧:**__

Markdown高阶流程图.png

5.数学公式

Markdown对数学公式的支持也很完美呢,可惜我是个学渣,在这里就不花时间介绍了,学生党可以百度下


好了,学习了以上的内容,你基本就可以写出一篇漂亮的博客或者论文了,行动去吧

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

推荐阅读更多精彩内容

  • 目录 概述简介官方文档Markdown编辑器 初级语法标题粗体和斜体段落和换行分隔线引言列表无序列表有序列表代码行...
    huihut阅读 29,255评论 1 27
  • 为什么学习Markdown 自从搭建了 Hexo 博客之后,发现还有 Markdown 这种写文章的方法,想到以后...
    lifeColder阅读 20,103评论 10 216
  • 1、窗体 1、常用属性 (1)Name属性:用来获取或设置窗体的名称,在应用程序中可通过Name属性来引用窗体。 ...
    Moment__格调阅读 4,461评论 0 11
  • Cmd Markdown 简明语法手册 标签: Cmd-Markdown 1. 斜体和粗体 使用 * 和 ** 表...
    zjfclimin阅读 945评论 0 1
  • 成功的速度一定要快于爸妈老去的速度 今年爸爸赚了很多钱 却很不确定 所以不能骄傲 还是要省着点用 过两年参加工作一...
    Pinkiss阅读 209评论 0 0