博客列表 >程序员必备技能五分钟教你学会Markdown的写作基本语法

程序员必备技能五分钟教你学会Markdown的写作基本语法

 一纸荒凉* Armani
 一纸荒凉* Armani原创
2021年03月18日 14:24:111561浏览

作为程序员,如果你还用word写作或者做笔记,那我强烈建议尝试下markdown写作。

首先,它不像word排版那么复杂,markdown只需要几个简单的快捷键,就能快速实现文档的排版。而且,如果你写博客,想在多个平台复制你的文章,markdown也不会因为复制粘贴而丢失格式。最后,markdown会让你更多的关注自己内容,而不是把时间花在各种花哨的排版上。

什么是markdown?

Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。所谓轻量级,就是使用简单的一些标记符号就可以快速实现文档排版,非常容易掌握 。

markdown的常用语法

下面简单介绍下一些最常用的语法:

1.标题

标题标记:#

  1. # 一级标题
  2. ## 二级标题
  3. ### 三级标题
  4. #### 四级标题
  5. ##### 五级标题
  6. ###### 六级标题

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

注:对应的html标签:&lt;h1&gt; ~ &lt;h6&gt;,效果<h1> ~ <h6>

  • 一级标题,在文本下面添加一个或以上的等号:=
  • 二级标题,在文本下面添加一个或以上的减号:-

2.引用

引用标记:>

  1. > 引用标记

效果

引用内容

引用嵌套

标题

3.公式块

公式块标记: § §

  1. $$
  2. 1*2=2
  3. $$

效果

12=21*2=2

4.列表

无序列表:可以使用、+、-、*

有序列表:数字+点号

  1. - 前端开发工具
  2. + html5 标记语言
  3. + css3 样式表
  4. + javascript 前端脚本
  5. + 流行的函数库或开发框架
  6. * jQuery
  7. * Vue.js
  8. * Node.js
  9. + Webpack 前端资源打包转换器
  10. 1. 后端开发语言
  11. 1. php 流行的Web开发语言
  12. 2. python 通用编程语言
  13. 3. java 通用编程语言
  14. <!-- 注意:如果有序列表的内容始终处于更新当中,建议只指明开始的序号即可,后面序号自动生成 -->
  15. - 商品分类
  16. 1. 家用电器
  17. 0. 电脑配件
  18. 0. 周边设备
  19. 0. 手机数码
  20. 0. 服装百货

效果

  • 前端开发工具
    • html5 标记语言
    • css3 样式表
    • javascript 前端脚本
    • 流行的函数库或开发框架
      • jQuery
      • Vue.js
      • Node.js
    • Webpack 前端资源打包转换器
  1. 后端开发语言
    1. php 流行的Web开发语言
    2. python 通用编程语言
    3. java 通用编程语言
  • 商品分类
    1. 家用电器
    2. 电脑配件
    3. 周边设备
    4. 手机数码
    5. 服装百货

5.分割线

在一行中使用三个或更多的 *、-或 _ 来添加分隔线(``):

  1. ------
  2. ***
  3. * * *
  4. ************************
  5. ---
  6. - - -

效果







6.代码块

  • 语法1: 在代码前缩进4个空格,或者1个制表符即可
  • 语法2: 使用三个反引号 ```
  • 语法3: 使用三个波浪线 ~~~
  • 语句4: 段落中的单行代码使用一个反引号或波浪线
  • 可以指定编程语言名称,以实现代码高亮

  1. function hello(name) {
  2. return 'Hello ' + name; //返回用户名
  3. }
  1. function hello(name) {
  2. return 'Hello ' + name; //返回用户名
  3. }

<!-- 会看到删除线提示:表示波浪线并不是推荐的语法形式, 加空格后提示消失 -->

  1. <?php
  2. $name = 'Peter Zhu';
  3. echo $name, '<br>';

<!-- 命令行 -->

  1. $ mkdir project
  2. $ cd project

pdo连接数据库的基本语法是: $pdo = new PDO(dsn,username, password),这也是推荐的方式

7.链接

  1. [链接文本](href属性的url地址,title的提示信息)

链接文本

  1. <a href="url" title="">php中文网</a>
  2. [php中文网](http://www.php.cn/, '国内最大的php学习平台')
  3. <!-- 如果想更精准的控制链接,请使用<a>标签 -->
  4. <a href="http://www.php.cn/" title="公益/实用/分享" target="_blank">

效果

<a href="url" title="">php中文网</a>

php中文网

<!-- 如果想更精准的控制链接,请使用<a>标签 -->

<a href="http://www.php.cn/" title="公益/实用/分享" target="_blank">

8.强调

1.语法:

  • 语法1: 被1个星号*或_包围的内容,会以斜体表示,转为< em >标签
  • 语法2: 被2个星号*或_包围的内容,会以粗体表示,转为< strong >标签

2.实战:

<!-- 注意: 使用下划线时,前后一定要添加空格,否则不能正确解析 -->

Markdown是一种可以使用 简单 的标记语法书写具有HTML的格式的 书写 工具

9.表格

  • 表格是数据格式化的重要工具,Markdown是使用减号-和竖线|画出表格的
  • 表格中的数据对齐方式是使用冒号(:)控制的
  1. |id|name|age|sex|salary|
  2. -|-|:-:|-|-:
  3. |1|Peter|28|male|3900|
  4. |2|Zhu|38|male|9900|
  5. |3|Lee|32|female|6700|

<!-- 表格由thead表头和tbody表格主体二部分组成,默认自带样式且不可改变 -->

<!-- 表头与主体的分隔区的橫线,即减号,数量并不限制,多个也行,但至少要有一个即可 -->

<!-- 单元格内容默认为左对齐,只需要改变冒号的位置就可以实现对齐方式的改变 -->

效果

id name age sex salary
1 Peter 28 male 3900
2 Zhu 38 male 9900
3 Lee 32 female 6700

10.图片

  • 图片的语法与链接非常相似,只需要在前面添加一个!叹号即可
  • ![提示文本](图片地址/url 'title提示')

可爱的狗狗

<!-- 文本:可爱的狗狗,当图片被禁止或者不能显示的时候会显示 -->

<!-- 图片是不是有点太大了,很遗憾,Markdown不支持调整图片大小,请用img标签调整 -->

<img src="dog.jpg" width="200">

<!-- 更多时候,你可能想给图片加一个链接,很简单,只需要将链接文本换成图片即可 -->

<!-- 第一步: 创建链接 -->

<!-- [](http://www.php.cn "php中文网") -->

<!-- 第二步:将图片插入到链接文本中 -->

可爱的狗狗

段落与换行总结

  • 段落对应生成html中的p标签
  • 多个段落之间一定要添加空行,否则不能识别
  • 段内换行,直接回车只会产生一个空格并不会产生换行
  • 如果要段内换行,必须在回车前敲入2个或以上的空格
  • 你可能猜到了,换行使用的br标签

更多语法,可以参考官方文档:

https://markdown-zh.readthedocs.io/en/latest/

常用的markdown工具推荐

mac平台:Ulysses、Bear
Windows:typora、Cmd Markdown、小书匠
互联网平台:CSDN、简书、印象笔记、有道云笔记、掘金等
这里推荐我常用markdown工具—typora,支持Windows/macOS,界面简洁优雅,内容所见即所得,最重要的是它完全免费。

下载地址:https://typora.io

TyporaWindows平台常用快捷键

  1. Ctrl+1 一阶标题
  2. Ctrl+2 二阶标题
  3. Ctrl+3 三阶标题
  4. Ctrl+4 四阶标题
  5. Ctrl+5 五阶标题
  6. Ctrl+6 六阶标题
  7. Ctrl+B 字体加粗(Blod)
  8. Ctrl+I 字体倾斜(Italic)
  9. Ctrl+U 下划线(Underline)
  10. Ctrl+Z 撤销
  11. Ctrl+T 创建表格(Table)
  12. Ctrl+L 选中某句话
  13. Ctrl+K 创建超链接
  14. Ctrl+D 选中某个单词
  15. Ctrl+F 搜索(Find)
  16. Ctrl+H 搜索并替换
  17. Ctrl+\ 清楚样式
  18. Ctrl+E 选中相同格式的文字
  19. Ctrl+Home 返回Typora顶部
  20. Ctrl+End 返回Typora底部
  21. Alt+Shift+5 删除线
  22. Ctrl+Shift+I 插入图片(Image)
  23. Ctrl+Shift+M 公式块
  24. Ctrl+Shift+K 代码块
  25. Ctrl+Shift+Q 引用(Quote)
声明:本文内容转载自脚本之家,由网友自发贡献,版权归原作者所有,如您发现涉嫌抄袭侵权,请联系admin@php.cn 核实处理。
全部评论
文明上网理性发言,请遵守新闻评论服务协议