Markdown基础教程

摘要:
其他特殊符号处理Markdown反斜杠插入语法中使用的特殊符号。事实上,Markdown最初的目标是为纯粹的写作而生的。因此,无法使用Markdown设置文本颜色。Markdown软件建议,如果你是Mac用户,我建议你使用开源MacDown:如果你愿意花钱,一些付费产品实际上更好。日常使用时,我使用Macdown。简单摘要Markdown是一种比html更简单的标记语言,主要用于日常写作。
基础语法

标题

Markdown支持6种级别的标题,对应html标签 h1 ~ h6

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

以上标记效果如下:

h1

h2

h3

h4

h5
h6

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

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

使用这种方式处理标题仅有两种表现形式,即一级标题和二级标题。遗憾的是,简书并不支持这种语法。因此,我们用一张图来展示效果:

img

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

段落及区块引用

需要记住的是,Markdown其实就是一种易于编写的普通文本,只不过加入了部分渲染文本的标签而已。其最终依然会转换为html标签,因此使用Markdown分段非常简单,前后至少保留一个空行即可。

而另外一个比较常见的需求就是,我们可能希望对某段文字进行强调处理。Markdown提供了一个特殊符号>用于段首进行强调,被强调的文字部分将会高亮显示

> 这段文字将被高亮显示...

以上标记显示效果如下:

这段文字将被高亮显示...

插入链接或图片

Markdown针对链接和图片的处理也比较简单,可以使用下面的语法进行标记

[点击跳转至百度](http://www.baidu.com)
![图片](https://upload-images.jianshu.io/upload_images/703764-605e3cc2ecb664f6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

以上标记显示效果如下:

点击跳转至百度

image-20200821162508715

注: 引用图片和链接的唯一区别就是在最前方添加一个感叹号。

列表

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

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

+ 黄瓜
+ 玉米
+ 茄子

- 黄瓜
- 玉米
- 茄子

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

以上标记显示效果如下:

  • 黄瓜

  • 玉米

  • 茄子

  • 黄瓜

  • 玉米

  • 茄子

  • 黄瓜

  • 玉米

  • 茄子

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

注:这里比较有趣的地方是,对于有序列表,Markdown将只关注你的第一个项目的数字编号。例如:如果第一个项目编号是3,以此类推,第二个项目应该是4,最终将显示为3、4、5。而如果你指定了第一个编号,后面的编号指定错误也没有关系,Markdown将只在乎你的第一个项目编号。

使用列表的一些注意事项

如果在单一列表项中包含了多个段落,为了保证渲染正常,*与段落首字母之间必须保留四个空格

*    段落一

     小段一
*    段落二

     小段二

以上标记显示效果如下:

  • 段落一

    小段一

  • 段落二

    小段二

另外,如果在列表中加入了区块引用,区域引用标记符也需要缩进4个空格

* 段落一
    > 区块标记一
* 段落二
    > 区块标记二
  • 段落一

    区块标记一

  • 段落二

    区块标记二

注:记住一个原则,如果在和列表配合使用的时候出现了问题,就缩进一次,四个空格或者一个制表符代表一次缩进。如果一次缩进没有解决问题,那就两次。

分隔线

有时候,为了排版漂亮,可能会加入分隔线。Markdown加入分隔线非常简单,使用下面任意一种形式都可以

***
---


产生分隔线的语法要求比较松,符号之间添加空格也可以。

强调

有时候,我们希望对某一部分文字进行强调,使用*或_包裹即可。使用单一符号标记的效果是斜体,使用两个符号标记的效果是加粗

*这里是斜体*
_这里是斜体_

**这里是加粗**
__这里是加粗__

这里是斜体
这里是斜体

这里是加粗
这里是加粗

高级用法

插入代码块

Markdown在IT圈子里面比较流行的一个重要原因是,它能够轻松漂亮地插入代码。

方法是,使用反引号`进行包裹即可。如果是行内代码引用,使用单个反引号进行包裹

这是一段var x = 3行内代码

如果插入一整段代码,需要至少使用两个以上反引号进行包裹, 看效果:

fun (x: Int, y: Int): Int {
  return x + y
}

注:很多人不知道怎么输入反引号。在英文模式下,找到键盘最左侧esc键下面的第一个键点击即可。

插入表格

表格是Markdown语法中比较复杂的一个,其语法如下:

表头|条目一|条目二
:---:|:---:|:---:
项目|项目一|项目二

以上标记显示效果如下:

表头条目一条目二
项目项目一项目二

注:三个短斜杠左右的冒号用于控制对齐方式,只放置左边冒号表示文字居左,只放置右边冒号表示文字居右,如果两边都放置冒号表示文字居中。

其它

特殊符号处理

Markdown使用反斜杠插入语法中用到的特殊符号。在Markdown中,主要有以下几种特殊符号需要处理:

   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

例如,如果你需要插入反斜杠,就连续输入两个反斜杠即可: => 。

注:在内容中输入以上特殊符号的时候一定要注意转义,否则将导致内容显示不全,甚至排版混乱。

如何给文字上色

使用Markdown的同学最郁闷的地方恐怕就是不能给文字添加颜色了。事实上,Markdown的最初目标就是为纯写作而生的。因此,它并没有考虑文字颜色这一点。所以,单纯使用Markdown设置文字颜色已经做不到了。但你可以这样做:

  1. 先用Markdown编辑完成
  2. 导出为html,在需要上色的部分手动添加标签保存即可。

Markdown软件推荐

如果你是一个Mac用户,我推荐你使用开源的 MacDown

image-20200821162804384

如果你愿意花钱的话,一些收费产品其实更好。例如:Byword,Ulysses,Typora等等都很不错。

日常使用,我就用Macdown。写书,我就用Ulysses。

简单总结

Markdown是一门比html更简单的标记语言,其主要用于日常写作。最终通过相应的编辑器或者脚本转换成html用于页面渲染。如果你是一个作家,或者是一个程序员,Markdown对你来说是一门必备的技能。掌握Markdown真的很简单,如你所见,这篇文章使用了这么短的篇幅就已经将Markdown的语法全部介绍完了。

免责声明:文章转载自《Markdown基础教程》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇devexpress gridControl1导出为pdf文件时出现 中文乱码的解决方案andoird软件开发之一个记录账号密码的APP--bmob后台下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

python爬虫:将本人博客园文章转化为MarkDown格式

本周又和大家见面了,首先说一下两周之后要进行研究生的期末考试,所以这次可能是考试之前的最后一更,我要忙着复习了,还请大家见谅,一般情况下我都是每周更新一篇技术原创。 好了,废话不多说,咱们进入今天的主题。由于我在简书也有自己的基地,所以每次在博客园文章更新完,还要在简书进行更新。由于简书文章的编辑格式是MarkDown,所以前几次更新修改格式都是非常麻烦,...

在notepad++中markdown高亮并实时预览

在notepad++中markdown高亮并实时预览 markdown是一种非常简洁、高效的标记语言,非常适合写博客、随笔,越来越受到大家欢迎。同时notepad++是Windows系统下使用非常广泛文本编辑器,但是非常遗憾的是otepad不默认支持markdown,但是感谢各位开发者,我们可以在notepad中使用markdown,并且能够实时预览。有的...

将多个markdown汇总成一个markdown或者pdf, 转换为电子书

需求: 比如这个项目, 它是电子书, 但是是md文件的集合, 需求就是, 怎么把它聚合成一个markdown, 或者pdf, 或epub等格式. 发现了这个项目, 它可以完成这个任务. 但是我发现需要改代码才能完成任务. 所以看看它是怎么实现的. 如何聚合成一个markdown文件. 巧妙: awk 'FNR==1{print ""}{print}' $(...

博客园入园手册2——Markdown编辑器1

  这篇给大家介绍博客园默认编辑器——Markdown编辑器。首先登陆账号,点击 我的博客 管理 设置默认编辑器,选择 Markdown 后,点击确认。点击新随笔,然后就可以开始写文章啦。   (下面的图示都是上一幅图是代码,下一幅图是显示效果) 一、标题   在 Markdown 中,只需要在文本前面加上 # 即可。具体见下图: 注意:# 与 【X级...

typora文件云同步

typora文件云同步 图片上传 安装picgo picgo网站 linux/windows安装后需要在typora中设定picgo的安装路径,linux安装picgo后可以在terminal中用which picgo找到picgo的路径。 安装坚果云 下载坚果云客户端 个人版本每月1G上传,3G下载流量,对于markdown这种文本是足够用了,客户端...

如何在Markdown文档中插入空格?

简单说  在 Markdown 文档中,可以直接采用 HTML 标记插入空格(blank space),而且无需任何其他前缀或分隔符。具体如下所示: 插入一个空格 (non-breaking space)          或          或        插入两个空格 (en space)   ...