love2wind

 2021-01-21  /   📝技巧教程,🧰软件  /   71 人浏览  /   0 条评论  /   全文共2757字

MARKDOWN语法详解

Markdown 是什么?

Markdown 是目前互联网上最流行的写作语言,它使用一些简单的符号(* / ` > [] () #)来标记文本格式,其简洁的语法、优美的格式以及强大的软件支持深受广大网友的喜爱。

维基百科上对 Markdown 的描述:

" Markdown 是一种轻量级标记语言,创始人是约翰·格鲁伯(John Gruber)。它允许人们 “使用易读易写的纯文本格式编写文档,然后转换成有效的 HTML 文档。”

大家千万不要被一些专业术语唬住了,其实 Markdown 之所以流行,最主要的原因就是因为它的学习门槛很低,你可能只需花几分钟就可以入门了。

Markdown 创始人约翰·格鲁伯(John Gruber)的博客

为什么要用 Markdown?

回想一下我们在写作的时候会遇到什么样的问题?

  • 软件不会用:Word 应该是大家写作时最常用的软件,每当打开一个 Word 文档,速度慢先不说,光是复杂繁多的功能就已经足够让你眼花缭乱了,如果你不是专业的编辑,相信绝大部分功能你是用不到的。消除浪费,应该是现代互联网时代大家最先要学会的事情。
  • 软件不兼容:这个想必是大家最痛苦的事情,我用的 Word 版本是 2016,你用的是 2003,两人互传资料,一打开格式全乱了。
  • 格式不兼容:从网上复制一段文字到 Word 文档中,然后格式全乱了。反之,从 Word 文档中复制一段文字到网上,格式也全乱了,又需要重新调整。
  • 排版太费时间:工具通常是这样,提供的功能越多,我们想的也越多,遇到的问题也就会越多。写作时总想着换种字体会不会好看一些,换个颜色试试,行高要不要调整一下,行距是不是太大了,用一下这个功能怎么样等等,时间就是这样一点点被浪费的。罗振宇在 2016 年 “时间的朋友” 跨年演讲中提到过一个观点我非常认同,他说:“当我需要一个服务的时候,不要给我太多选择,请直接告诉我什么是最好的,我要你的最佳方案”。
  • 难以团队协作:如果一个项目需要多人共同参与,比如共同翻译一本书,你可能需要版本管理、相互 Review、开放试读、开源、自出版等等,这些使用 Word 是无法满足需求的。也许你说可以使用 Google Doc,但前提是没那么多人会科学上网。

Markdown 如何解决这些问题的呢?

  • 语法简单: Markdown 的语法是一些简单而且常用的标记符号,任何人只要花几分钟就能学会;
  • 兼容性强: Markdown 是兼容性非常强的纯文本内容,可以使用任何编辑器打开,格式都不会乱;
  • 导出方便: Markdown 可以导出 PDF、Word、HTML、Epub、LaTeX 等文件格式;
  • 专注内容: 使用 Markdown 写作再也不用纠结排版,其简洁优雅的格式会让你沉浸到写作的乐趣之中;
  • 团队协作: Github、Gitlab、Gitbook 都支持 Markdown,团队协作再也不是问题了;

PS:本文节选自 《Markdown 实用指南》

什么时候不合适用 Markdown 呢?

  • 需要复杂排版的时候,比如纸版图书编辑就不太适合用 Markdown。我的做法是从 Markdown 导出 Word 文档,然后交给编辑。
  • 需要复杂表格的时候,因为 Markdown 对表格的支持太简单了。
  • 需要调整图片大小或直接贴本地图片的时候。

Markdown 怎么用?

先熟悉 Markdown 语法,再学会使用 Markdown 工具。请记住,语法是一切的基础,熟悉了语法以后,使用什么工具都可以,好用的工具只是让效率更高而已。

Markdown 语法分为:标准语法扩展语法

标准语法适用于所有 Markdown 工具,扩展语法可能每个工具都不一样。

为什么会有扩展语法呢?

由于 Markdown 本身的功能有限,一些特定的需求和场景无法被满足,因此产生了许多第三方的扩展语法。根据不同的需求和场景, Markdown 被扩展了很多功能,比如待办事项(任务列表)、代码高亮。

比较流行的扩展语法是 Github 风格的 Markdown:GitHub Flavored Markdown,毕竟全球最大的程序员『交友』网站。

正是由于 Markdown 第三方扩展语法太多,存在一定程序的碎片化,因此有一些机构和公司试图对 Markdown 语法进行标准化,这个可以参考 CommonMark

Markdown相比WYSIWYG编辑器:

优点:

  • 因为是纯文本,所以只要支持Markdown的地方都能获得一样的编辑效果,可以让作者摆脱排版的困扰,专心写作。
  • 操作简单。比如:WYSIWYG编辑时标记个标题,先选中内容,再点击导航栏的标题按钮,选择几级标题。要三个步骤。而Markdown只需要在标题内容前加#即可

缺点:

  • 需要记一些语法(当然,是很简单。五分钟学会)。
  • 有些平台不支持Markdown编辑模式。

本站文章短代码

文章代码

## 调用站内文章 > 这里主要展示本站的短代码及其用法,基础markdown语法参考下面文章。 [post]2176[/post] `用的时候把 @ 符号删掉....

一、标题

在想要设置为标题的文字前面加#来表示,一个#是一级标题,二个#是二级标题,以此类推,支持六级标题。

注:标准语法一般在#后跟个空格再写文字

示例:

# 这是一级标题

## 这是二级标题

### 这是三级标题

#### 这是四级标题

##### 这是五级标题

###### 这是六级标题

效果如下:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

二、字体

加粗

要加粗的文字左右分别用两个*号包起来

斜体

要倾斜的文字左右分别用一个*号包起来

斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

删除线

要加删除线的文字左右分别用两个~~号包起来

示例:

**这是加粗的文字**

*这是倾斜的文字*`

* **这是斜体加粗的文字** *

~~这是加删除线的文字~~

效果如下:

这是加粗的文字

这是倾斜的文字`

*这是斜体加粗的文字*

这是加删除线的文字

三、引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>

n个...

貌似可以一直加下去,但没神马卵用

示例:

>这是引用的内容    
>>这是引用的内容    
>>>>>>>>>>这是引用的内容

效果如下:

这是引用的内容

这是引用的内容

这是引用的内容

四、分割线

三个或者三个以上的 - 或者 * 都可以。

示例:

---
----
***
*****

效果如下:

可以看到,显示效果是一样的。




五、超链接

链接也分行内式和参数式

行内式语法:

[超链接名](超链接地址 "超链接title")
title可加可不加

示例:

[涅槃博客](https://love2wind.cn)

[书苑网文精排社](https://nicepub.top)

效果如下:

涅槃博客

书苑网文精排社

注:Markdown本身语法不支持链接在新页面中打开,貌似简书做了处理,是可以的。别的平台可能就不行了,如果想要在新页面中打开的话可以用html语言的a标签代替。

<a href="超链接地址" target="_blank">超链接名</a>

示例
<a href="https://www.jianshu.com/u/1f5ac0cf6a8b" target="_blank">简书</a>

参数式语法

[博客]: https://love2wind.cn "博客"
[书苑网文精排社]: https://nicepub.top "书苑"
这里是[博客],这里是[书苑网文精排社]

效果:

这里是博客,这里是书苑网文精排社

这里是[博客],这里是[书苑网文精排社]

六、列表

无序列表

语法:

无序列表用 - + * 任何一种都可以

- 列表内容
+ 列表内容
* 列表内容

注意:- + * 跟内容之间都要有一个空格

效果如下:

  • 列表内容
  • 列表内容
  • 列表内容

有序列表

语法:

数字+.+空格+内容
1. 列表内容
2. 列表内容
3. 列表内容

注意:序号跟内容之间要有空格

效果如下:

  1. 列表内容
  2. 列表内容
  3. 列表内容

八、表格

语法:

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略

示例:

| 姓名 | 技能 | 排行 |
| ---- | ---- | ---- |
| 刘备 | 哭   | 大哥 |
| 关羽 | 打   | 二哥 |
| 张飞 | 骂   | 三弟 |

效果如下:

姓名技能排行
刘备大哥
关羽二哥
张飞三弟

九、代码块

单行代码

单行代码:代码之间分别用一个反引号包起来。

`hello world`

hello world

多行代码

多行代码:代码之间分别用三个反引号包起来,且两边的反引号单独占一行。

<div class="sidebox fixside s_ping" >
<h4 class="sidebox__title">新冠动态</h4>
<i class="bg-primary"></i>
                    <iframe width="100%" frameborder="0" src="https://www.lovestu.com/api/project/cnmapyinqing/obj.php" onload='this.style.height=Math.max(this.contentWindow.document.body.scrollHeight,this.contentWindow.document.documentElement.scrollHeight,200)+"px";'></iframe>

</div>

十、图像

图片分行内式和参数式

![行内式图片](图片链接或路径)

[参数式图片]: 图片链接或路径 //这里是![参数式图片]

效果:

博客

图片居中、宽高和内嵌链接

<center class="half">
    <a href="https://www.starts.sh/"> //内嵌链接
    <img src="图片链接或路径" width="宽" height="高"/>
</center></a>

效果:

img

十一、其他

字体类型

<font face="微软雅黑">无二自留地</font>

效果:

无二自留地

字体大小

<font face="微软雅黑" size=5>无二自留地</font> //从 1 到 7 的数字,浏览器默认值是 3

效果:

无二自留地

字体颜色

<font face="微软雅黑" color=#FF0000 size=gray>无二自留地</font>

效果:

无二自留地

文本居中

<center><font face="微软雅黑" color=gray size=gray>无二自留地</font></center>

效果:

无二自留地

分段

分段两种方法,空行或者 <p>文本</p> 例:

<p>“假如这里有坚固的高墙和撞墙破碎的鸡蛋,我总是站在鸡蛋一边。—— 村上春树”</p>

空格

文章开头空格两种方法,输入法全角敲两下 space 键,或者文章前输入   例:

<p>&emsp;&emsp;“假如这里有坚固的高墙和撞墙破碎的鸡蛋,我总是站在鸡蛋一边。—— 村上春树”</p>

下划线

给文本添加下划线,例:

<u>“假如这里有坚固的高墙和撞墙破碎的鸡蛋,我总是站在鸡蛋一边。—— 村上春树”</u>

文章截断

博客文章截断

<!--more-->

emoji表情

Markdown语法支持添加emoji表情,输入不同的符号码(两个冒号包围的字符)可以显示出不同的表情。

比如输入:smile:,可以显示 :smile: 表情。

更多表情请点击这个表情库

Markdown 编辑器推荐

名称说明平台资费
Typora支持所见即所得的另类写作神器。macOS、Windows、Linux免费
MacDownMacOS上类似Mou的编辑器。macOS免费
Bear应该是编辑器中的瑞士军刀。iPhone、iPad、macOS免费+内购
MarkdownPad可以是Windows上的最强的编辑器。Windows免费+收费
Markdown XAndroid轻量的编辑器。Android免费

哪些网站支持 Markdown?

简书、知乎、CSDN、Github、Gitlab、Gitbook 全部都支持 Markdown 写作。

 赞  赏

如果觉得我的文章对你有用,请随意赞赏

感谢您的支持,我会继续努力的!

扫码支持
扫码打赏,你说多少就多少

打开   或者 扫一扫,即可进行扫码赞赏哦

原创文章,版权属于:涅槃博客 - love2wind
本文链接:https://love2wind.cn/archives/2176.html(转载时请注明本文出处及文章链接)
作品采用:《署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)》许可协议授权

发表评论

涅槃博客

涅槃博客

Love2wind's blog