初学markdown
分段与标题
分段
正如markdown文档所说的,段落是由若干行组成的,段落之间以一行空行分开。(也就是每一段的前后都要有一个空行)
一个 Markdown段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。
>Markdown语法说明标题
学习markdown最先接触的自然是标题了,#号的多少直接代表标题的级数,级数越大,标题越小。(比如#####title代表5级标题,不过实际最多用到4级吧-,-) 以下为一些标题的实例。
#一级##二级###三级####四级
# 一级
## 二级
### 三级
#### 四级
区块引用
使用一个>符号来表示引用,其后的内容会以引用形式出现。重复使用>即可实现多重区块。(比如>>>会出现3级区块)
>这是一个区块实例>>>这是一个三级区块,在区块内部,所有语法也均可使用
这是一个区块实例
这是一个三级区块,在区块内部,所有语法也均可使用
有序和无序列表
无序列表使用 (*
),(-
) 或者(+
)来使用,有序列表则直接使用数字加点的形式。需要注意的是,在符号和列表内容之间需要一个空格去分开。
-错误使用
- 正确使用
-错误使用
- 正确使用
其次,列表可以使用空格进行缩进嵌套,最多3层。一个列表下可以有多个段落,只要有同样的缩进即可(即4个空格或者一个Tab),若是不愿每行缩进,则至少保证每段段首有缩进)
>- a
> 这是第一段> 这是第二段
> - b
> - c
- a
这是第一段
这是第二段
- b
- c
最后需要注意的是,在列表内使用代码区块需要缩进8个空格或者2个Tab,而不是4个空格。
代码区块
代码区块的作用显而易见,保持原本的代码格式便于查阅,浏览。同时,在代码区块中markdown语法不会生效,可以用来编写介绍markdown相关语法的内容。
区块引用采用>符号来标明,而代码区块的使用更加明了,直接一个Tab缩进即可。
这是一个段首:
这是一个代码区块
分割线
熟悉的分割线的使用方法也很简单,3个星号,减号均可。
***
* * *
---
链接
介绍
虽说说明文档里将链接归为区段元素,之上介绍的分割线区块引用等分为区块元素。不过个人比较懒,也就不细分了。
链接分为两种方式,行内式和参考式。两种方法有共同指出也有不同之处。共同之处为链接文字均用中括号表示
不同之处即为链接的位置。顾名思义,行内式即为在行内直接插入链接。而参考式则指定一个id,后续对id进行定义。格式
行内式 [链接文字](链接地址 "title")参考式 [链接文字][id]参考式定义 [id]: 链接地址 "title"或‘title’或(title)
结论
显而易见,行内式明显没有参考式功能强大,不过胜在简单。而参考式正确的使用方法自然是在文中标记,在文末或者某一个固定的地方进行集中定义,这样统一管理自然省心。其次,在文章中频繁出现冗长的链接着实令人不开心,阅读修改体验太差,而这也是选择参考式的原因之一。
Tips:若要链接到本地资源,使用相对地址即可。
强调
使用星号(*
)和下划线(_
)可以对内容进行强调,最多可使用强调两次,即(**
)或(__
)。
需要强调的是,两个强调符号的两边不能都为空格,否则无效。
*s*
代码
使用两个反引号(`
)可以将一段代码标记出来,所以若要在代码区段内插入反引号,则需要多个反引号来解决。
这是printf('hello world');
同时,若要在代码的一开始使用反引号,则需要在被标记内容前后添加一个空格。
`前后添加空格可以显示出前后的两个反引号`
图片
图片的使用和链接类似,不做过多介绍,唯一的区别,即为在链接地址前增加一个感叹号。即
![链接文字](链接地址 "title")
目前markdown无法对图片进行进一步调整,不过可以通过img标签来进行。
图片本打算直接本地上传,尝试多次不成,后来发现简书可以上传到服务器上,再加上本地上传也有不便之处。
图片上传就先这样做吧。
遇到的问题
- 在简书中正常,到博客园就有了一些问题,查证才发现,是因为简书对一些内容的规范降低了,虽然好写,不过兼容性不好。
- 任何区块,还是要前后都留空行。
- 代码确实是一个Tab的事,不过需要前后留空。
- 注意空格数量,尽量使用Tab。
- 列表的3级缩进无法实现。
- (已解决)若用单行代码表示(
`
)时,在一段内若还有单行代码表示,会导致反引号匹配错误。
参考内容
- Markdown语法说明(简体中文版)
转载于:https://www.cnblogs.com/ysrcyx/p/5823642.html
初学markdown相关推荐
- Reveal.js:把你的 Markdown 文稿变成 PPT
Reveal.js:把你的 Markdown 文稿变成 PPT https://github.com/hakimel/reveal.js 通过 Reveal.js 这个框架, 我们可以把 Markdo ...
- markdown 本地链接_Markdown从入门到入坑
给大家安利一款我最近特别喜欢的软件typora. 是什么:typora是一款用Markdown语言编写文档的软件.那么问题来了,什么是Markdown? Markdown是一个标记性语言,使用约定好的 ...
- GitHub+Hexo搭建个人网站
title: GitHub+Hexo 搭建个人网站详细教程 date: 2019-04-13 13:42:36 tags: 个人网站 categories: 技术 搭建步骤: 获得个人网站域名 申请域 ...
- Markdown与 $\LaTeX$ 公式的使用入门指南
文章目录 一.Markdown是什么? 二.Markdown编辑工具 三.Markdown基本语法简介 1.文档结构相关 2.表格 3.图片 4.插入代码 5.添加脚注 6.文档目录 7.与`html ...
- 支持markdown的服务器,基于tornado实现的一个markdown解析服务器
makrdown 在 mac 有个不错的图形编辑器Mou Mou左边编辑,右边自动预览,相当巴适,可导出为html和pdf. 初学tornado,于是想到写个简单的web服务器,让浏览器来预览编写的m ...
- notebook python 已停止工作_Python/Jupyter Notebook初学遇到的一些问题总结(20201108)...
在开始之前先写下我的系统,window10家庭版,安装的是python3.8,没有安装anaconda 虽然大多数人都推荐安装anaconda,不过我实在是搞不明白anaconda,所以在这写一写我的 ...
- 学python哪个app比较好_初学python编程,有哪些不错的软件值得一用?
初学python编程,有哪些不错的软件值得一用? 萧楚故人 发表于 2020-7-17 00:17:55 只看该作者 只看大图 倒序浏览 阅读模式 10 19832 下载好向圈APP可以快速联系圈友 ...
- 老夫聊发少年狂之初学编程
老夫聊发少年狂之初学编程 毕业多年,80年代学的计算机早就还给的老师,现在重新开始学习编程 欢迎使用Markdown编辑器 你好! 这是你第一次使用 Markdown编辑器 所展示的欢迎页.如果你想学 ...
- @[springboot初学,附北京尚学堂教程网址
@springboot初学,附北京尚学堂教程网址https://www.bjsxt.com/a/10247.html 欢迎使用Markdown编辑器 你好! 这是你第一次使用 Markdown编辑器 ...
最新文章
- 关于学习Python之后的一点总结(1->符号优先级->for->range())
- python 均值滤波_Python的一个骚操作
- 搭建 Django 开发环境
- fedora如何隐藏顶部状态栏_藏在 iOS 13 里的 9 个隐藏小技巧
- win7 IE11卸载后无法上网
- 关于unicode,mbcs,utf8,charset,encoding等相关概念的说明
- 关于驰骋工作流程引擎节点访问规则的变更发布
- jquery mini下载_【芒果tv湖南卫视直播】-芒果TV播放器下载v6.3.4 官方正式版
- 计算机基础知识试题及答案填空题,计算机基础知识练习题及答案解析
- Linux从入门到指令详解
- php免费获取天气预报
- 关于androidstudio获取shal的总结
- windows自带的文件校验工具MD5,SHA1,SHA256
- 如何读懂和利用你的微生物多样性测序结果?
- 谷歌seo优化主要做什么?
- The view Myapp.views.welcome didn‘t return an HttpResponse object. It returned None instead.
- CSS总结---持续更新中 2022.8.4
- 区块链技术在食品供应链领域的应用
- 西安交大计算机学院 栾佳锡,史椸-西安交通大学-自动化科学与工程学院
- 这是个什么软件Android,想提高语文水平,不妨试试这几个APP(Android)