Markdown 的目标是实现「易读易写」。
可读性,无论如何,都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,>并且看起来不会像是由许多标签或是格式指令所构成。Markdown 语法受到一些既有 text-to-HTML >格式的影响,包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText,而最>大灵感来源其实是纯文本电子邮件的格式。
总之, Markdown 的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。比如:在文>字两旁加上星号,看起来就像强调。Markdown 的列表看起来,嗯,就是列表。Markdown 的区块引>用看起来就真的像是引用一段文字,就像你曾在电子邮件中见过的那样。
markdown语言的基本标签
所有的Markdown语言标签在使用中都应当是需要在后面带一个空格再加内容来使用的。
这是一个一级标题
1 | # 一级标题 |
这是一个二级标题
这是一个三级标题
这是一个四级标题
这是一个五级标题
这是一个六级标题
段落1
段落2
- 普通引用方式
引用内容
1 | > 这是葛木小舍先生的第一篇博客 |
- Bootstrap Callout
使用方式
1 | {% note class_name %} Content (md partial supported) {% endnote %} |
其中, class_name
可以是以下列表中的一个值:
default
*Content of default bs-callout
primary
Content of primary bs-callout
success
*Content of success bs-callout
info
Content of info bs-callout
warning
*Content of waning bs-callout
danger
Content of danger bs-callout
- 这是一个无序列表
- 这是一个无序列表
1
2- 这是一个无序列表
* 这是一个无序列表
- 这是一个父类列表
- 这是一个子类列表
- 这是一个个人博客的链接
1 | [葛木小舍先生的小世界](https://gemumiaoshe.wordpress.com/) |
这是葛木小舍先生的个人博客
https://gemumiaosheWordPress.com
1
2
3这是葛木小舍先生的个人博客
<https://gemumiaosheWordPress.com>
#这里是直接用尖括号<地址>来直接构成链接。
- 这里是插入图片链接的两种方式:
1 | ![这是一张图片](https://upload-images.jianshu.io/upload_images/95646-5bfd0cecf587c766.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/600) |
1 | <img src="https://upload-images.jianshu.io/upload_images/95646-5bfd0cecf587c766.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/600" width=200px hight=200px alt="简书" left > |
在这里,就插入图片的地址有两点需要注意,图片地址可以是它的网页存储地址,如果是本地的相对地址,则需要注意。
你可以选择把你需要用到的图片上传到网页上保存,再来进行引用。在这里使用的图片都是使用的第一种方式,我的图片是存在github上的。
1 | <!--代码段--> |
这是一段倾斜字体
这是一段加粗字体
这是一段倾斜加粗字体
1 | *这是一段倾斜字体* |
- 表格
表头一 | 表头二 | 表头三 |
---|---|---|
左对齐 | 居中对齐 | 右对齐 |
- 代码
1 | 表头一|表头二|表头三| |
markdown相关编译器
由于我比较懒,所以并没有专门下载相关的编译器。我本身是使用Dw编写的。markdown是纯文本文档,所以它是一门可以用任何文档编辑器打开编辑的语言。而编辑器只是给我们提供一个辅助的作用,可以给我们提供方便。
- 专业的markdown编译工具:
用户可以通过键盘快捷键和工具栏按钮来使用或者移除 Markdown 格式。MarkdownPad左右栏的分割方式令用户可以实时看到 HTML 格式的 Markdown 文档。
Mou 是 Mac下杰出的 Markdown 编辑器,提供语法高亮、在线预览、同步滚动、全屏模式,支持自定保存、自动匹配,允许自定义主题,支持 CSS,HTML 和 PDF 导出等。
MarkPad 是款开源的 Markdown 编辑器,与 Window 8 风格和谐友好的界面,可以直接在你的博客或者 GitHub 中打开、保存文档,直接将图片粘贴到 Markdown 文档中。
MarkdownEditor 是一款基于浏览器的 Markdown 文本编辑器,功能非常简单实用。
保存
最后将编辑好的markdown文档保存为.md格式就可以用对应工具编辑和查看效果了。
markdown标记语言因其简洁性,被常用于博文等文档的编写。本博客是基于hexo搭建的,其中博客也都是基于markdown语言编写的。
参考
- 献给写作者的 Markdown 新手指南
这是我参考过的简书上的一个markdown新手教程 - Markdown 语法说明
这是我参考的一个markdown的简体中文版语法说明文档
- 献给写作者的 Markdown 新手指南