分段与标题

  • 分段

    正如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个星号,减号均可。

***
* * *
---

链接

  1. 介绍

    虽说说明文档里将链接归为区段元素,之上介绍的分割线区块引用等分为区块元素。不过个人比较懒,也就不细分了。
    链接分为两种方式,行内式和参考式。两种方法有共同指出也有不同之处。共同之处为链接文字均用中括号表示
    不同之处即为链接的位置。顾名思义,行内式即为在行内直接插入链接。而参考式则指定一个id,后续对id进行定义。

  2. 格式

     行内式    [链接文字](链接地址 "title")参考式    [链接文字][id]参考式定义 [id]: 链接地址 "title"或‘title’或(title)
  3. 结论

    显而易见,行内式明显没有参考式功能强大,不过胜在简单。而参考式正确的使用方法自然是在文中标记,在文末或者某一个固定的地方进行集中定义,这样统一管理自然省心。其次,在文章中频繁出现冗长的链接着实令人不开心,阅读修改体验太差,而这也是选择参考式的原因之一。

    Tips:若要链接到本地资源,使用相对地址即可。

强调

使用星号(*)和下划线(_)可以对内容进行强调,最多可使用强调两次,即(**)或(__)。
需要强调的是,两个强调符号的两边不能都为空格,否则无效。

*s* 

代码

使用两个反引号(`)可以将一段代码标记出来,所以若要在代码区段内插入反引号,则需要多个反引号来解决。
这是printf('hello world');
同时,若要在代码的一开始使用反引号,则需要在被标记内容前后添加一个空格。
`前后添加空格可以显示出前后的两个反引号`

图片

图片的使用和链接类似,不做过多介绍,唯一的区别,即为在链接地址前增加一个感叹号。即

![链接文字](链接地址 "title")

目前markdown无法对图片进行进一步调整,不过可以通过img标签来进行。
图片本打算直接本地上传,尝试多次不成,后来发现简书可以上传到服务器上,再加上本地上传也有不便之处。
图片上传就先这样做吧。

遇到的问题

  • 在简书中正常,到博客园就有了一些问题,查证才发现,是因为简书对一些内容的规范降低了,虽然好写,不过兼容性不好。
  • 任何区块,还是要前后都留空行。
  • 代码确实是一个Tab的事,不过需要前后留空。
  • 注意空格数量,尽量使用Tab。
  • 列表的3级缩进无法实现。
  • (已解决)若用单行代码表示(`)时,在一段内若还有单行代码表示,会导致反引号匹配错误。

参考内容

  1. Markdown语法说明(简体中文版)


转载于:https://www.cnblogs.com/ysrcyx/p/5823642.html

初学markdown相关推荐

  1. Reveal.js:把你的 Markdown 文稿变成 PPT

    Reveal.js:把你的 Markdown 文稿变成 PPT https://github.com/hakimel/reveal.js 通过 Reveal.js 这个框架, 我们可以把 Markdo ...

  2. markdown 本地链接_Markdown从入门到入坑

    给大家安利一款我最近特别喜欢的软件typora. 是什么:typora是一款用Markdown语言编写文档的软件.那么问题来了,什么是Markdown? Markdown是一个标记性语言,使用约定好的 ...

  3. GitHub+Hexo搭建个人网站

    title: GitHub+Hexo 搭建个人网站详细教程 date: 2019-04-13 13:42:36 tags: 个人网站 categories: 技术 搭建步骤: 获得个人网站域名 申请域 ...

  4. Markdown与 $\LaTeX$ 公式的使用入门指南

    文章目录 一.Markdown是什么? 二.Markdown编辑工具 三.Markdown基本语法简介 1.文档结构相关 2.表格 3.图片 4.插入代码 5.添加脚注 6.文档目录 7.与`html ...

  5. 支持markdown的服务器,基于tornado实现的一个markdown解析服务器

    makrdown 在 mac 有个不错的图形编辑器Mou Mou左边编辑,右边自动预览,相当巴适,可导出为html和pdf. 初学tornado,于是想到写个简单的web服务器,让浏览器来预览编写的m ...

  6. notebook python 已停止工作_Python/Jupyter Notebook初学遇到的一些问题总结(20201108)...

    在开始之前先写下我的系统,window10家庭版,安装的是python3.8,没有安装anaconda 虽然大多数人都推荐安装anaconda,不过我实在是搞不明白anaconda,所以在这写一写我的 ...

  7. 学python哪个app比较好_初学python编程,有哪些不错的软件值得一用?

    初学python编程,有哪些不错的软件值得一用? 萧楚故人 发表于 2020-7-17 00:17:55 只看该作者 只看大图 倒序浏览 阅读模式 10 19832 下载好向圈APP可以快速联系圈友 ...

  8. 老夫聊发少年狂之初学编程

    老夫聊发少年狂之初学编程 毕业多年,80年代学的计算机早就还给的老师,现在重新开始学习编程 欢迎使用Markdown编辑器 你好! 这是你第一次使用 Markdown编辑器 所展示的欢迎页.如果你想学 ...

  9. @[springboot初学,附北京尚学堂教程网址

    @springboot初学,附北京尚学堂教程网址https://www.bjsxt.com/a/10247.html 欢迎使用Markdown编辑器 你好! 这是你第一次使用 Markdown编辑器 ...

最新文章

  1. 关于学习Python之后的一点总结(1->符号优先级->for->range())
  2. python 均值滤波_Python的一个骚操作
  3. 搭建 Django 开发环境
  4. fedora如何隐藏顶部状态栏_藏在 iOS 13 里的 9 个隐藏小技巧
  5. win7 IE11卸载后无法上网
  6. 关于unicode,mbcs,utf8,charset,encoding等相关概念的说明
  7. 关于驰骋工作流程引擎节点访问规则的变更发布
  8. jquery mini下载_【芒果tv湖南卫视直播】-芒果TV播放器下载v6.3.4 官方正式版
  9. 计算机基础知识试题及答案填空题,计算机基础知识练习题及答案解析
  10. Linux从入门到指令详解
  11. php免费获取天气预报
  12. 关于androidstudio获取shal的总结
  13. windows自带的文件校验工具MD5,SHA1,SHA256
  14. 如何读懂和利用你的微生物多样性测序结果?
  15. 谷歌seo优化主要做什么?
  16. The view Myapp.views.welcome didn‘t return an HttpResponse object. It returned None instead.
  17. CSS总结---持续更新中 2022.8.4
  18. 区块链技术在食品供应链领域的应用
  19. 西安交大计算机学院 栾佳锡,史椸-西安交通大学-自动化科学与工程学院
  20. 这是个什么软件Android,想提高语文水平,不妨试试这几个APP(Android)

热门文章

  1. CSDN - 进程结束后new出的内存会回收吗?
  2. MySQL5.5复制新特性
  3. swift 中showAlertTitle的使用
  4. WebGL 3D 工业隧道监控实战
  5. thinkphp-条件判断-范围判断-range标签
  6. 关于Less的学习笔记
  7. WCF实现RESTFul Web Service
  8. Directx11教程(6) 画一个简单的三角形(2)
  9. 粒子滤波 应用_如何使用NativeScript开发粒子物联网应用
  10. react创建组件_如何使用React创建时间轴组件