Markdown与Wiki

Markdown

·概述

[Markdown是一种轻量级的「标记语言」]通常为程序员群体所用,目前它已是全球最大的技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用书写格式。Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。


·区块元素

1.标题

标题是每篇文章必备而且最常用的格式。
在Markdown中,如果想将一段文字定义为标题,只需要在这段文字前面加上 #,再在 # 后加一个空格即可。
还可增加二、三、四、五、六级标题,总共六级只需要增加 # ,增加一个 # 标题字号相应降低一级。

如图:
标题.png
2. 列表

列表格式也很常用,它可以让你的文稿变得井井有条。
在 Markdown 中,你只需要在文字前面加上 - 就可以了,
如果你希望是有序列表,在文字前面加上 1. 2. 3. 即可。
注:-、1.和文字之间要保留一个字符的空格。
如图:


列表.png
3.引用

如果你需要在文稿中引用一段别处的句子,那么就要用到「引用」格式。
在引用文字前加上 > 并与文字保留一个字符的空格,即可。与标题一样,引用也分级别,>>是二级标题、>>>是三级标题

如图:
引用.png
4. 分割线

分割线的语法只需要另起一行,连续输入三个星号 *** 即可分割两段文字内容。
如图:


分割线.png

·区段因素

1.链接与图片

链接:在 Markdown 中,插入链接只需要使用 显示文本 即可。
图片:在 Markdown 中,插入图片只需要使用即可。
注:插入图片的语法和链接的语法很像,只是前面多了一个 !
如图:

图片.png

链接又分为行内式、参考式和 自动链接

链接.png
2.自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样.

例如:
1.png

在markdown转换成:
2.png

邮址的自动链接也很类似,只是 Markdown 会先做一个编码转换的过程,把文字字符转成 16 进位码的 HTML 实体,这样的格式可以糊弄一些不好的邮址收集机器人。

例如:
3.png

在markdown会转换成:
4.png
3.反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em> 标签),你可以在星号的前面加上反斜杠.
5.png

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
6.png
4.代码

代码分为行内代码和代码块。
行内代码使用 代码 标识,可嵌入文字中
代码块使用4个空格或```标识

这里是代码

代码语法高亮在 ```后面加上空格和语言名称即可

//注意语言前面有空格
这里是代码

例如:
代码1.png

效果如下:
这是行内代码onCreate(Bundle savedInstanceState)的例子。

这是代码块和语法高亮:
代码2.png
5.表格

居左::----
居中::----:或-----
居右:----:

例子:
表格1.jpg

效果如图:
表格2.png

Wiki

·概述

Wiki是一种在[网络]上开放且可供多人协同创作的由沃德·坎宁安于1995年首先开发,这种超文本系统支持面向社群的协作式写作,同时也包括一组支持这种写作。沃德·坎宁安将wiki定义为“一种允许一群用户用简单的描述来创建和连接一组的社会计算系统”。Wiki站点可以有多人(甚至任何访问者)维护,每个人都可以发表自己的意见,或者对共同的主题进行扩展或者探讨。

·特点

WiKi是一个供多人协同写作的系统。与博客、论坛等常见系统相比

WiKi有以下特点:

1.使用方便

维护快速:快速创建、更改网站各个页面内容。
格式简单:基础内容通过文本编辑方式就可以完成,使用少量简单的控制符还可以加强文章显示效果。
链接方便:通过简单的“[[条目名称]]”,可以直接产生内部链接。外部链接的引用也很方便。

2.自组织

自组织的:同页面的内容一样,整个超文本的相互关联关系也可以不断修改、优化。
可汇聚的:系统内多个内容重复的页面可以被汇聚于其中的某个,相应的链接结构也随之改变。

3. 可增长

可增长:页面的链接目标可以尚未存在,通过点选链结,我们可以创建这些页面,使系统得以增长。
修订历史:记录页面的修订历史,页面的各个版本都可以被取得。

4. 开放性

开放的:社群内的成员可以任意创建、修改、或删除页面。
可观察:系统内页面的变动可以被来访者清楚观察得到。

·常见的几种形式

1.将代码忽略
1.png
2.链接(外)
2.png
3.标题
3.png
4.数字列表
5.png
5.符号列表
6.png
6.链接(内)
7.png

*Markdown与Wiki的转换

HTML是表现网页的,Markdown是给文字排版的。

如果你要把HTML转成Markdown,首先要把很多无法对应的HTML标签过滤掉,然后再把HTML标签替换成Markdown标签。同时应注意,HTML有很多版本,语法不太相同,而且还有样式表的问题,转换后恐怕无法保留网页的一些显示效果。

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