MARKDOWN语法详解

  • 📝教程
  • 2365 阅读
  • 2021年01月21日
  • 0 条评论
  • 全文共2757字, 阅读大约需要7分钟
  • 搜索引擎已收录

首页 / 📝教程 / 正文

AI摘要
Gemini 1.5 Pro
|
此内容根据文章生成,并经过人工审核,仅用于文章内容的解释与总结
反馈

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] `用的时候把 @ 符号删掉` ```html [@post]文章mid[/post] ``` ## 线状标题 [jline]当前线状标题[/jline] `用的时候把 @ 符号删掉` ```html [@jline]当前线状标题[/jline] ``` ## 按钮短代码 [btn href="链接" type="#409eff"]蓝按钮[/btn] [btn href="链接" type....

一、标题

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

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

示例:

  1. # 这是一级标题
  2. ## 这是二级标题
  3. ### 这是三级标题
  4. #### 这是四级标题
  5. ##### 这是五级标题
  6. ###### 这是六级标题
复制代码

效果如下:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

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

二、字体

加粗

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

斜体

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

斜体加粗

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

删除线

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

示例:

  1. **这是加粗的文字**
  2. *这是倾斜的文字*`
  3. * **这是斜体加粗的文字** *
  4. ~~这是加删除线的文字~~
复制代码

效果如下:

这是加粗的文字

这是倾斜的文字`

*这是斜体加粗的文字*

这是加删除线的文字

三、引用

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

n个...

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

示例:

  1. >这是引用的内容
  2. >>这是引用的内容
  3. >>>>>>>>>>这是引用的内容
复制代码

效果如下:

这是引用的内容

这是引用的内容

这是引用的内容

四、分割线

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

示例:

  1. ---
  2. ----
  3. ***
  4. *****
复制代码

效果如下:

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




五、超链接

链接也分行内式和参数式

行内式语法:

  1. [超链接名](超链接地址 "超链接title")
  2. title可加可不加
复制代码

示例:

  1. [涅槃博客](https://nie.su)
  2. [书苑网文精排社](https://nicepub.top)
复制代码

效果如下:

涅槃博客

书苑网文精排社

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

  1. <a href="超链接地址" target="_blank">超链接名</a>
  2. 示例
  3. <a href="https://www.jianshu.com/u/1f5ac0cf6a8b" target="_blank">简书</a>
复制代码

参数式语法

  1. [博客]: https://nie.su "博客"
  2. [书苑网文精排社]: https://nicepub.top "书苑"
  3. 这里是[博客],这里是[书苑网文精排社]
复制代码

效果:

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

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

六、列表

无序列表

语法:

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

  1. - 列表内容
  2. + 列表内容
  3. * 列表内容
  4. 注意:- + * 跟内容之间都要有一个空格
复制代码

效果如下:

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

有序列表

语法:

  1. 数字+.+空格+内容
  2. 1. 列表内容
  3. 2. 列表内容
  4. 3. 列表内容
  5. 注意:序号跟内容之间要有空格
复制代码

效果如下:

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

八、表格

语法:

  1. 表头|表头|表头
  2. ---|:--:|---:
  3. 内容|内容|内容
  4. 内容|内容|内容
  5. 第二行分割表头和内容。
  6. - 有一个就行,为了对齐,多加了几个
  7. 文字默认居左
  8. -两边加:表示文字居中
  9. -右边加:表示文字居右
  10. 注:原生的语法两边都要用 | 包起来。此处省略
复制代码

示例:

  1. | 姓名 | 技能 | 排行 |
  2. | ---- | ---- | ---- |
  3. | 刘备 || 大哥 |
  4. | 关羽 || 二哥 |
  5. | 张飞 || 三弟 |
复制代码

效果如下:

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

九、代码块

单行代码

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

  1. `hello world`
复制代码

hello world

多行代码

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

  1. <div class="sidebox fixside s_ping" >
  2. <h4 class="sidebox__title">新冠动态</h4>
  3. <i class="bg-primary"></i>
  4. <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>
  5. </div>
复制代码

十、图像

图片分行内式和参数式

  1. ![行内式图片](图片链接或路径)
  2. [参数式图片]: 图片链接或路径 //这里是![参数式图片]
复制代码

效果:

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

  1. <center class="half">
  2. <a href="https://www.starts.sh/"> //内嵌链接
  3. <img src="图片链接或路径" width="宽" height="高"/>
  4. </center></a>
复制代码

效果:

十一、其他

字体类型

  1. <font face="微软雅黑">无二自留地</font>
复制代码

效果:

无二自留地

字体大小

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

效果:

无二自留地

字体颜色

  1. <font face="微软雅黑" color=#FF0000 size=gray>无二自留地</font>
复制代码

效果:

无二自留地

文本居中

  1. <center><font face="微软雅黑" color=gray size=gray>无二自留地</font></center>
复制代码

效果:

无二自留地

分段

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

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

空格

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

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

下划线

给文本添加下划线,例:

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

文章截断

博客文章截断

  1. <!--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
本文最后更新于2021年09月15日00时11分59秒,已超过1336天没有更新,若内容或图片失效,请留言反馈
本文链接:https://niepan.org/archives/2176.html(转载时请注明本文出处及文章链接)
作品采用:《署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)》许可协议授权

发表评论

博主 - <?php $this->author->screenName(); ?>

love2wind

记录生活,分享世界