[TOC]

MarkDown 是什么?

想了很久,第二篇文章写什么好呢。这篇文章既要让大家感兴趣,又要让大家马上能够用上。脑袋里搜索了好久,最后MarkDown出现了。下面引用百度百科的介绍:

Markdown 是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。Markdown 的语法简洁明了、学习容易,而且功能比纯文本更强,因此有很多人用它写博客。世界上最流行的博客平台 WordPress 和大型 CMS 如 Joomla、Drupal 都能很好的支持 Markdown。完全采用 Markdown 编辑器的博客平台有 Ghost 和 Typecho。

看完后你可能还是一头雾水,只知道MarkDown看上去很厉害,好多博主都用它写文章。心里可能在想,我可没有博主们厉害,一定学不会的。但博主们也是普通人,他们原来也是小白,很多都是通过写博客才了解MarkDown的。但当他们熟悉了MarkDown后,没有人再用传统的方式写博客了。想知道为什么他们放弃了使用这么久的写作习惯吗,那继续往下看吧。我相信,你看完这一系列的文章后,你也会加入我们的队伍的。

举个例子

在阅读本文之前,大家在写作时,一般都会用 Word 或 WPS 写作,文档也大都以微软的 .doc, .docx 格式储存。还有人为了保证文档发给谁都能正常打开,会用 .txt 格式。但是.doc 或 .docx 格式有如下问题:

  1. 不一定谁都能打开。旧版的 Word 就打不开新版的 Word 文档。
  2. 对方看到的文档的样子和你自己看到的可能差别很大,尤其是 WPS 和 Word 之间。
  3. 大部分人电脑上的 Office 都是盗版的,使用时很容易出问题。
  4. 用.txt 写的文档没有格式,这就给编辑你文档的人带来困扰了。

可能有的人会说,将 Word 文档转成 .pdf 格式不就就解决了吗。对,没错,.pdf格式文档确实是比较完美的解决办法。为什么说是比较完美的呢,我相信各位在生活中一定遇到过这样的场景,需要修改 .pdf 文档里面的内容,或者是删除某些页面,或者是从其他文档里面添加新的页面,等等等等。这个时候,.pdf 文档的劣势就出现了,对于一般人来说,这会很麻烦,.pdf 不像 .docx 或者 .txt 文件一样,可以轻易地修改,它需要专门的软件来处理。但 .pdf 文档又有特别多的优点,比如阅读方便、特别适合打印、特别适合屏幕上阅览、加密特性等等,那有没有什么格式的文档既能有 .txt 文档一样方便打开,又能像 .docx 文档一样便于调节格式,还能特别方便地转化成 .pdf 文档呢。

MarkDown 闪亮登场

首先,千万不要被「标记」、「语言」吓到,MarkDown 的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。但就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。

MarkDown 的优点

说了这么多,那MarkDown格式的文档相较于其他格式的文档到底有什么优点呢。

  1. 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
  2. 兼顾了「什么人都能打开」和「样式」两个方面。MarkDown 就是纯文本,就是 .txt,所以什么人都能打开。而如上所述,你可以用它来标记文本的样式,而且语法非常简单。
  3. 由于是纯文本格式,Markdown 文稿也不会因为未来软件升级而产生不同版本之间的兼容问题,即,不会出现「我这篇稿子是用旧版 Word 写的,你用新版 Word 看可能格式会有点问题」的情况。
  4. 让你专注于文字而不是排版。
  5. 格式转换方便。MarkDown 的文本格式为 .md,你可以轻松地将 .md 转换为 .html、.pdf 等。
  6. MarkDown 转 HTML 非常方便。HTML 是整个万维网(web)的标记语言,但更重要的是,它也是目前主流电子书格式所用的标记语言。无论是 .epub,.mobi,还是 Kindle 用的专有格式 .azw,都只是把一堆 HTML 文件打包而已。如果你写的是书,用 MarkDown 标注格式之后,可以很方便地转为以上格式(当然这个转换工作不需要由你来做);如果你写的是单篇的文章(例如论文或者报告),未来也不排除结集出书的可能。若采用 MarkDown,对于日后的文件转换工作也大有裨益。
  7. 如何开始用 MarkDown?继续用你习惯的写作软件即可。记事本、Word、Pages 都没问题,但请记得存成纯文本格式。就这么简单。
  8. MarkDown 的标记语法有极好的可读性。

MarkDown 的缺点

MarkDown 好像没有啥缺点,我至今还没发现。如果说真要有的话,可能是没有Word那样支持特别多的格式。什么意思呢,比如你想要修改某些字的颜色,标准的MarkDown语法是不支持的,当然,这是可以解决的,就是引入HTML的语法了。不过我感觉没有必要,因为,大家用MarkDown写作一般都是为了记笔记,日记这些东西,并不需要很多格式,而需要的是提供一个安静写作的场景,在这个场景里你不必为了排版而经常打断你的思绪。 我相信,很多人看到这篇文章是为了论文排版。博主我曾经也尝试过用MarkDown+R的方式排版过论文,不过,排出来的效果并不如Word排出来的符合论文标准。如果,大家想排出一份漂亮的科技论文,我在这里向大家隆重推出排版界的王者,LaTex。后面我也会出LaTex系列的文章和论文模板的。 回到正题,虽然没有任何一个事物是完美的,也没有任何一个软件可以完成你所有的需求,但是如果你想找一个适合快速写作的软件,或者说是语法,那么MarDown绝对是你的不二之选。

MarkDown 的基础语法

听完这么多,是不是特别想学习呢。那话就不多说,下面正式开始我们的学习之旅。不过要注意一点的是,你自己做出来的效果可能和我不一样,这是因为我们采用了不同的主题,或者说是不同的 CSS 样式表所导致的。这一些内容,会在后面的教程里谈到的。

标题

这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。而在 MarkDown 中,你只需要在文本前面加上 # 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。MarkDown 支持 6 种级别的标题,对应 HTML 标签 h1 ~ h6。l例如:

# h1
## h2
### h3
#### h4
##### h5
###### h6

注:# 和标题之间建议保留一个字符的空格,这是最标准的 MarkDown 写法。以上标记效果如下:(为了不破坏本文的结构,采用图片的形式进行展示。采用 Typora 的 Pyxill 主题进行渲染。)

除此之外,Markdown 还支持另外一种形式的标题展示形式,其类似于 Setext 标记语言的表现形式,使用下划线进行文本大小的控制

这是一级标题
===
这是二级标题
---

以上标记效果如下:(为了不破坏本文的结构,采用图片的形式进行展示。采用 Typora 的 Pyxill 主题进行渲染。)

这种处理方式在 Github 的一些开源工程上面比较常见,显而易见的缺点是:文字大小控制级别有限。

段落及区块引用

需要记住的是,MarkDown 其实就是一种易于编写的普通文本,只不过加入了部分渲染文本的标签而已。其最终依然会转换为 html 标签,因此使用 MarkDown 分段非常简单,将你要分段的部分前后至少保留一个空行即可。 而另外一个比较常见的需求就是,我们可能希望对某段文字进行强调处理。Markdown 提供了一个特殊符号 > 用于段首进行强调,被强调的文字部分将会高亮显示。例如:

> 如果你不相信努力和时光,那么时光第一个就会辜负你。不要去否定你的过去,也不要用你的过去牵扯你的未来。不是因为有希望才去努力,而是努力了,才能看到希望。

其显示结果如下:

如果你不相信努力和时光,那么时光第一个就会辜负你。不要去否定你的过去,也不要用你的过去牵扯你的未来。不是因为有希望才去努力,而是努力了,才能看到希望。

注1:聪明的你可能已经发现了,上面显示的引用效果和文章开头引用百度百科的效果是一样的。没错,本站所有文章均采用 MarkDown 语法写作,而且大家在评论时也可以采用 MarkDown 语法进行评论。这也是为什么第二篇文章为什么写 MarkDown 的原因之一了。至于我渲染出来的结果为什么跟你不一样,这是因为我们采用了不同的 CSS 进行调节,这一内容会在后面的高级教程进行讲解。 注2:引用完后,一定记得空出一行再写其他东西,不然,你接下来写作的内容也都在引用内容里。 注3:> 与你要引用的文字之间一定有一个空格,不然会被认为是普通的文本。> 前面不能有文字,必须单独一行才能引用(比如这样,只会被认为是普通文本)。

目录

MarkDown引入目录非常简单,只需要在你想加入目录的地方输入 [TOC] 就可以了。

首行缩进方法

在中文书写时我们通常习惯段首缩进两个字,但是使用 MarkDown 编辑时我们手打空格缩进是不起效果的,因此我们需要通过使用 HTML 中的空格实体来帮助我们实现缩进效果。 为了让本文不那么难以理解,这一部分我只打算讲一个,也是我比较推荐的一个, 因为网站显示原因,所以才这么写的。大家一定要记住分号是英文分号,而不是中文分号)。 一个汉字占两个空格大小,所以使用四个空格就可以达到首行缩进两个汉字的效果。而一个 代表两个空格,所以用两个 就代表两个汉字、四个空格了。

换行

在 MarkDown 之中我们会发现文字无法换行,始终集中在一行之中。这时如果需要换行那么该怎么办呢?在这里我们可以使用 “换行标签” </br>。例如:

上段文字</br>下段文字

其显示结果如下: 上段文字
下段文字

分割线

分割线可以由 *-_ (星号,减号,底线)这 3 个符号的至少 3 个符号表示,注意至少要 3 个,且不需要连续,有空格也可以。例如:

***
---
___
* * *
****

其显示结果如下:






粗体和斜体

MarkDown 的粗体和斜体也非常简单,用** 或者__包含一段文本就是粗体的语法,用* 或者一个 _ 包含一段文本就是斜体的语法。例如:

*始于颜值、陷于才华、忠于人品*
_始于颜值、陷于才华、忠于人品_
**始于颜值、陷于才华、忠于人品**
__始于颜值、陷于才华、忠于人品__

其显示结果如下: 始于颜值、陷于才华、忠于人品 始于颜值、陷于才华、忠于人品 始于颜值、陷于才华、忠于人品 始于颜值、陷于才华、忠于人品

删除线

~~包含一段文本就是删除线了。例如:

~~请删除我~~

其显示结果如下: ~~请删除我~~

列表

Markdown 支持有序列表和无序列表两种形式:

  • 无序列表使用 * 或 + 或 - 标识
  • 有序列表使用数字加. 标识,例如:1.
* 黄瓜
* 玉米
* 茄子+ 黄瓜
+ 玉米
+ 茄子- 黄瓜
- 玉米
- 茄子1. 黄瓜
2. 玉米
3. 茄子1. 黄瓜
1. 玉米
1. 茄子3. 黄瓜
2. 玉米
1. 茄子

其显示结果如下:

  • 黄瓜
  • 玉米
  • 茄子

  • 黄瓜
  • 玉米
  • 茄子

  • 黄瓜
  • 玉米
  • 茄子

  1. 黄瓜
  2. 玉米
  3. 茄子

  1. 黄瓜
  2. 玉米
  3. 茄子

  1. 黄瓜
  2. 玉米
  3. 茄子

注1:有序表不用1. 2. 3. 这样排下去,可以直接1. 1. 1. 这样,如果以3. 开头,如3. 2. 1. 这样,那么结果是3. 4. 5. 。即以什么数字开头,结果就以什么数字开头,后面的数字可以随便写。如果中间要再插入一项,就不用修改整个列表的序号了。 如果需要写多级列表,这可以用缩进的办法实现,例如:

1. 动物1. 哺乳动物1. 爬行动物1. 鸟类1. 其他
1. 植物1. 被子植物1. 裸子植物1. 其他

其显示结果如下:

  1. 动物
  2. 哺乳动物
  3. 爬行动物
  4. 鸟类
  5. 其他
  6. 植物
  7. 被子植物
  8. 裸子植物
  9. 其他

代办清单 To-do List

你可以在 MarkDown 中编写代办清单,相关代码如下:

- [x] 已完成项目1- [x] 已完成事项- [ ] 代办事项
- [ ] 代办项目2
- [ ] 代办项目3

因为某些不可知的原因,不能在正文里显示,下面采用 Typora 的 Pyxill 主题渲染结果进行展示。

MarkDown 的高级语法

通过上一节的讲解,我们现在已经可以进行简单的纯文字写作了。你可能想问,MarkDown只能处理纯文本吗,那如果我想插入表格,图片,公式等等该怎么办。不要急,我将会在下一篇文章进行讲解,点击MarkDown高级教程即可查看。

MarkDown 软件推荐

对于初学者,我推荐你使用Typora,无论是OS X系统,还是Windows系统,还是Linux系统,都有相应的版本。Typora的优点太多了,我列举了几点:

  • 简洁美观
  • 实时预览
  • 扩展语法
  • 跨平台
  • 免费

点击MarkDown 编辑器介绍了解更多优秀的工具。顺手的编辑器会让你的写作更加丝滑,快来挑选属于你的编辑器吧。

MarkDown 转 PDF

写完 MarkDown 后,如果我想和别人分享我的文章怎么办呢,如果别人没有 MarkDown 渲染的软件又该怎么办呢。不要急,点击 MarkDown 转 PDF 链接进行学习。

个人网站推广

大家好,我正在搭建一个分享各种效率软件的网站,这是网站主页地址,http://www.huangpan.net

github pages markdown_排版利器——MarkDown入门简介相关推荐

  1. Markdown入门简介

    参考 http://sspai.com/25137 作者: Te_Lee 文章来源: 少数派 Markdown入门简介(使用工具Haroopad) 一.使用的工具----haroopad(http:/ ...

  2. github pages markdown_赏金$25000的GitHub漏洞:通过 GitHub Pages 不安全的Kramdown配置实现多个RCE...

    0x01 开篇 我一直在关注GitHub企业版的发布说明,主要关注补丁的bug修复.这次,我发现补丁发布对Kramdown中的一个问题进行了关键修复. CVE-2020-14001的描述很好地总结了漏 ...

  3. 如何利用GitHub Pages快速构建免费网站?

    无需编程,零成本!只需挑选一个主题,经过配置,加入内容即可. 作者 | Stephen Vinouze 译者 | 弯月,责编 | 郭芮 头图 | CSDN 下载自东方IC 出品 | CSDN(ID:C ...

  4. 轻松上手写作利器 Markdown:从此文章排版无烦恼

    写作是每个人日常生活和工作中必不可少的内容,无论是写博客.写邮件,还是写报告.写项目方案,都无法避免写作. 在使用 Word 或类似编辑工具写作时,想必你一定纠结过字体.字号.间距等等的排版问题吧! ...

  5. Github Pages入门教程

    一.什么是 GitHub Pages 官方给出的说明:您和您的项目的网站,直接从您的GitHub存储库托管.只需编辑,推送,您的更改就会生效. 二.为什么使用Github Pages 搭建简单而且免费 ...

  6. GitHub Pages 中文简介

    什么是 GitHub Pages GitHub Pages 是一个静态站点托管服务. Github 页面旨在直接从 GitHub 仓库中直接托管您的个人.组织或项目页面.了解关于 GitHub Pag ...

  7. MarkDown入门及技巧

    MarkDown入门及技巧 你可以在Github上看到这篇文档的纯文本https://github.com/onlynight/ReadmeDemo/tree/master/Readmes/MarkD ...

  8. Github Pages + Jekyll 独立博客一小时快速搭建上线指南

    只要一小时?! 人生道路上布满了坑,于是有了人生导师.  美丽的地球上布满了坑,于是有了Google Earth.  使用Github Pages搭建独立博客的过程中布满了坑,所以有了这篇指南. 我在 ...

  9. 【Hexo博客搭建】将其部署到GitHub Pages(三):怎么写作以及更新?

    简介: 本系列文章属于半笔记半教程的零基础小白入门文,教你将 Hexo 部署到 GitHub Pages 应该怎么做,跟着此系列文章最终可以获得自己的静态博客网站.流程很长,分成不同的篇幅,此为本系列 ...

最新文章

  1. 网上商城代码实现_中国中铁网上商城转型敏捷开发模式,实现快速反应、快速迭代...
  2. c/c++宏函数的定义与使用(宏定义函数)(macro definition)
  3. boost::locale::to_upper用法的测试程序
  4. WinPcap编程调试解决办法
  5. 手机调用系统的拍照和裁剪功能,假设界面有输入框EditText,在一些手机会出现点击EditText会弹出输入法,却不能输入的情况。...
  6. 工作392-选择Hbuilder x导入项目
  7. 串口开发,数据类型转换——字符串转 byte[],byte[]转二进制,二进制转十进制转byte[],byte[]转十进制,byte[]拼接,校验
  8. c语言子查询返回子菜单,T-SQL基础(三)之子查询与表表达式
  9. 如何落地云原生DevOps?
  10. 常用技巧 —— 位运算
  11. 如何在复杂的分布式系统中做测试
  12. POJ3748 位操作【位运算+STL】
  13. python多线程并发每秒6000_Python多线程并发的误区
  14. 使用Google的项目(源码)托管服务(转)
  15. linux wps 数学符号,2016版WPS数学符号如何输入
  16. 基于javaweb+jsp的汽车租赁管理系统(JavaWeb JSP MySQL Servlet SSM SpringBoot Layui Ajax)
  17. 华为网络设备——利用三层交换机实现VLAN间路由配置实例
  18. 计算机的所有符号,电脑上怎么打各种符号
  19. 我要偷偷的学Python,然后惊呆所有人(第一天)
  20. 免费搭建个人网站流程!马上拥有自己的网站!

热门文章

  1. 第三周课程总结及实验报告(一)
  2. unittest中的测试固件
  3. 定时器里面的作用域问题
  4. protobuf简单序列化反序列化示例
  5. DF学数据结构系列——B树(B-树和B+树)介绍
  6. [转]项目经理面试指南
  7. 50.什么是内部碎片?什么是外部碎片?
  8. 延迟放学,让“996父母”松了口气
  9. Erlang 之父去世,他留给程序员两点忠告
  10. 傅立叶变换物理意义解析进阶