Markdown实用教程

Markdown 是用来编写结构化文档的一种纯文本格式,它使我们在双手不离开键盘的情况下,可以对文本进行一定程度的格式排版。markdown语法是通用的,很多写作平台都是支持markdown的,比如简书,这就意味着做自媒体的你写一次文章,就能很快同步到各大平台,而不需要要考虑不同写作平台之间排版的兼容性,从而兼顾各大平台的流量,让你能专注于写作。

优点

  • 简单易学;
  • 支持的平台都能通用,省去排版的烦恼;

缺点

  • 需要记一些语法,不过这比记26个英文单词要简单多了,五分钟学会;
  • 有些平台是不支持markdown的,比如知乎,这么大个平台,不支持markdown;

工具 typora

Typora 是一款支持实时预览的 Markdown 文本编辑器。它有 OS X、Windows、Linux 三个平台的版本,并且由于仍在测试中,是完全免费的。

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

markdown语法

这里列出一些常用的markdown语法,学会这些,99%的书写排版工作,我相信都能应对了。

1. 标题

在想要设置为标题的文字前面加#来表示,并且用空格将#和标题分隔开。一个#是一级标题,二个#是二级标题,以此类推。支持六级标题。

示例:

# 我是一级标题
## 我是二级标题
### 我是三级标题

效果如下:

我是一级标题

我是二级标题

我是三级标题

2. 字体

平时用word写作的时候,我们需要将关键字黑体加粗,或者斜体标出,为了让读者更能清晰看到我们想表达的东西。

  • 加粗

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

  • 斜体

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

  • 斜体加粗

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

  • 删除线

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

示例:

**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~

效果如下:

这是加粗的文字

这是倾斜的文字

这是斜体加粗的文字

这是加删除线的文字

3. 引用

在写作时候,有时候为了提升文章的档次和逼格,我们可能会引用别人的东西,对于引用的东西,我们最好用引用标识出来,以免产生误会。引用语法是>,在需要引用的前面加>标识即可。

示例:

>这是引用杜甫的诗《登高》:万里悲秋常作客,百年多病独登台。

效果:

这是引用杜甫的诗《登高》:万里悲秋常作客,百年多病独登台。

4. 分割线

有时候想人为将文章分为几部分,这时候可以用分割线:三个或者三个以上的 - 或者 * 都可以,我通常用3个,省手指。

示例:

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

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

5. 图片

你需要首先让这张图片可以在互联网刚开访问,才能在这里使用。语法

![该位置可写可不写](图片地址)

比如这张图片是可以访问的:http://qiniu.ikeguang.com/ikeguang.com/image/bi.jpg 你复制地址到浏览器地址栏是可以直接访问的。

示例:

![装逼真讨厌](http://qiniu.ikeguang.com/ikeguang.com/image/bi.jpg)

效果:

image

6. 超链接

有时候我们想点击几个文字,就能跳到一个地址,而不是一长串地址,因为有的地址很长,很难看。

上面两个地址,显然第二个可读性更好。

语法:

[要显示的文字](网址)

示例:

[安装Python教程](http://www.ikeguang.com/?p=220)
[中国大学排名](http://www.ikeguang.com/?p=1409)

效果:

安装Python教程

中国大学排名

7. 列表

列表包括无序列表和有序列表。

无序列表

在要做列表的前面用-+*任意一种标识,并且用空格隔开。

语法:

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

效果如下:

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

有序列表

用数字加点,并且用空格隔开:

语法:

1. 我是有序列表;
1. 我是有序列表;
1. 我是有序列表;
  1. 我是有序列表;
  2. 我是有序列表;
  3. 我是有序列表;

列表嵌套

有时候可能分的层次很细,这时候就需要嵌套列表。

示例:

- 湖北
【两个空格】- 黄冈
【两个空格】- 十堰
 - 。。。
- 湖南
 【两个空格】- 长沙
 【两个空格】- 。。。
- 。。。

效果:

  • 湖北
    • 黄冈
    • 十堰
    • 。。。
  • 湖南
    • 长沙
    • 。。。
  • 。。。

8. 表格

插入普通表格需要构建如下的格式:

表头 表头
第1行第1列 第1行第2列
第2行第1列 第2行第2列

示例:

序号 | 姓名 | 年龄
---|---|---
1 | 柯广| 25 |
2|柯小广|18

效果:

序号 姓名 年龄
1 柯广 25
2 柯小广 18

默认情况下是左对齐的,下面介绍左对齐,右对齐,居中对齐,添加:符号即可。

左对齐

示例:

序号 | 姓名 | 年龄
:---|:---|:---
1 | 柯广| 25 |
2|柯小广|18

效果:

序号 姓名 年龄
1 柯广 25
2 柯小广 18

右对齐

示例:

序号 | 姓名 | 年龄
:---|:---|:---
1 | 柯广| 25 |
2|柯小广|18

效果:

序号 姓名 年龄
1 柯广 25
2 柯小广 18

居中对齐

示例:

序号 | 姓名 | 年龄
:---:|:---:|:---:
1 | 柯广| 25 |
2|柯小广|18

效果:

序号 姓名 年龄
1 柯广 25
2 柯小广 18

9. 代码

代码块用三个点`包起来,词语用单个抱起来

代码块:

where there is a will,there is a way

单个词语:

有人喜欢装`13`,不说好的,非要说`Good`。

效果:
有人喜欢装13,不说好的,非要说Good

10. 流程图

流程图的语法大体分为两部分:

  • 流程图元素定义部分;
  • 连接流程图元素部分,该部分用来指明流程图的执行走向。
flow
st=>start: Start
op=>operation: Your Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op

效果:

微信截图_20201125231901.png

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


fastjson2 是 fastjson 项目的重要升级,目标是为下一个十年提供一个高性能的 JSON 库,同一套 API 支持JSON/JSONB 两种协议,JSONPath 是一等公民,支持全量解析和部分解析,支持 Java 服务端、客户端Android、大数据场景。 fastjson 2 代码
博文目录文章目录问题描述解决方案问题描述阿里云ECS, 系统切换为 Aliyun Linux 2.1903 LTS 64位 后, SSH可以连接, SFTP无法连接, 端口 22 已添加到阿里云ECS网络安全组表现为 Xshell 可以连接, Xftp 使用 SFTP 协议无法连接, 一片空白, 很长时间也不报错提示, 鼠标挪动的时候显示为圆圈(等待响应)解决方案将 /etc/ssh/sshd_config 中的Subsystem sftp /usr/libexec/opens
博文目录文章目录创建项目创建代码仓库完成工程代码并提交推送到仓库application.propertiespom.xml创建构建计划设置流程配置阶段说明 测试阶段说明 部署定义远程服务器信息远程服务器鉴权创建 SSH 密钥录入凭据在 持续集成 的 构建脚本 中做 SSH 鉴权操作远程服务器设置触发规则设置变量与缓存CODING 持续集成 帮助文档当下 DevOps, CI/CD 等概念非常火, 我自己也想试试, 碰巧知道 CODING.NET 免费提供了这个能力, 所以来尝试一把, 好在最终有
下载CentOS官网CentOS下载CentOS-7-x86_64-DVD-2003.isoCentOS-7-x86_64-DVD-2003.iso安装
博文目录文章目录服务端客户端测试效果服务端配置到 nginx 反向代理FRP Releases使用frp进行内网穿透FRP 示例FRP 实例 通过自定义域名访问内网的 Web 服务FRP 参考 服务端配置FRP Linux Server ReleaseFRP Windows Client Release服务端在 linux 上执行 arch, 结果如果是 [X86_64] 即可选择 [linux amd64] 版本的 Release 包wget https://github.co
博文目录文章目录环境下载安装配置使用环境阿里云ECS(Aliyun Linux 2.1903 LTS 64位)下载https://www.oracle.com/java/technologies/oracle-java-archive-downloads.htmlJava SE 8 (8u202 and earlier) 可以用于商业Java SE 8 (8u211 and later) 不可以用于商业安装tar -zxvf jdk-8u202-linux-x64.tar.gz 得到
博文目录文章目录环境下载安装配置使用环境阿里云ECS(Aliyun Linux 2.1903 LTS 64位)下载https://maven.apache.org/download.cgi安装tar -zxvf apache-maven-3.6.3-bin.tar.gz 得到解压包配置在 /root/.bashrc 文件内添加如下内容export MAVEN_HOME=/mrathena/application/maven-3.6.3export PATH=$JAVA_HOME/
博文目录文章目录嵩山版(2020.08.03)阿里开发手册官网嵩山版(2020.08.03)手册的详细版叫做 码出高效
博文目录文章目录EncodingFontMavenGradleOtherPluginsEncodingsetting 搜索 encodFile | Settings | Editor | File Encodings, 3个 UTF-8File | Settings | Tools | SSH Terminal, 1个 UTF-8Fontsetting 搜索 fontFile | Settings | Editor | FontMavensetting 搜索 mavenFile |
博文目录文章目录环境下载安装配置使用参考环境阿里云ECS(Aliyun Linux 2.1903 LTS 64位)下载http://nginx.org/en/download.htmlhttp://nginx.org/download/nginx-1.18.0.tar.gz选择稳定版(Stable version)下载即可, 分 linux 和 windows 两种, linux 版下载的是源码, 需要自行编译安装tar -zxvf nginx-1.18.0.tar.gz 得到解压包
博文目录文章目录单密钥方式多密钥方式默认生成的 rsa密钥位置在 ~/.ssh, 如 C:Usersmrathena.ssh. 各代码托管平台是可以使用同一个SSH密钥的, 这样最方便, 但是为了更安全也可以配置在不同的平台使用不同的密钥单密钥方式cmd 执行命令 ssh-keygen -t rsa -b 4096 -C "generic", -t type rsa, -b 位数 4096位, 如果不用 -C 指定邮箱, 则会生成一个默认的注释, 该注释无关紧要, 不影响验证选项全部默认(
博文目录文章目录环境下载安装配置使用参考环境阿里云ECS(Aliyun Linux 2.1903 LTS 64位)下载https://github.com/git/git/releaseshttps://codeload.github.com/git/git/tar.gz/v2.28.0, 下载之后可以重命名为 git-2.28.0.tar.gz安装tar -zxvf apache-maven-3.6.3-bin.tar.gz 得到解压包make prefix=/mrathena/a
博文目录文章目录环境下载安装简单配置汉化皮肤JDKMaven简单使用环境阿里云ECS(Aliyun Linux 2.1903 LTS 64位)下载Jenkins 官网, 支持选择中文https://www.jenkins.io/选择 LTS 长期支持版的最新版下载, 这里是 2.235.3 LTS, Generic Java package (.war) 是 java war 包, 可以通过 java -jar jenkins.war 直接运行官网下载 wget http://mir
原因分析 是因为使用了pycharm的版本的问题。并不是flask框架本身的问题(不管你是如何设置的flask配置,通过加载config也好,还是通过run的时候传入形参也好,均不影响) 可以很明显的
背景 兜兜转转以为做测试不用接触这么多编程,结果不仅要接触 py,还要接触 java,还有 elixir,更有 Lua,啊 我绝望了 太久没玩 Java,连导入项目都不会了...特此记录一下侮辱性的时
1. 安装制作工具 mkisofs 2. Linux 操作系统镜像 iso 打包 3. 校验并写入 md5 值
最近在学习 MySQL 的 bin-log 时候考虑到数据备份的问题,突然想到如果能将数据通过 Linux 命令行方式备份到百度网盘,那是一件多么牛逼的事情。百度网盘有免费的 2TB 存储空间,而且有
作为一名开发者,熟悉使用 git 代码管理工具是一项必备的基本技能。git 相较 SVN 而言,其优点不言而喻。git 的功能非常强大,其包括的操作命令也非常的多,但是从实用性而言,很多命令可能我们一
kickstart 能实现 linux 系统的自动化安装,需要设置 ks.cfg 文件,而这个 ks.cfg 文件的生成最好使用 system-config-kickstart 工具生成,比较准确,也
介绍 GitBook是一个基于Node.js的命令行工具,可使用 Github/Git和Markdown来制作精美的电子书,GitBook 并非关 Git的教程。 导出格式有PDF、HTML等,需要添