Markdown 使用教程

前言

  以前经常在 github 中看到 .md 格式的文件,一直没有注意,也不明白为什么文本文档的后缀不是 .txt ,后来无意中看到了 Markdown,看到了用这个东西写得一些web界面等特别的规整漂亮,顿时不明觉厉。后来自己学习了一下,感觉这个语言确实简洁、美观,现推荐出来供大家学习和玩玩,希望能对你有用。

  本文图文并茂,避免了单纯看语法的枯燥和繁琐,其实,学习一门新东西真的其乐无穷!

简介  

Markdown 是一种用来文本处理的轻量级 「标记语言」,它用简洁的语法代替排版,而无需像Microsoft的Word一样需要花费大量的时间进行排版、字体设置。它使我们专心于码字,用「标记」语法,来代替常见的排版格式。Markdown不止可以处理文本,使得文字更美观,还支持图像、表格等的插入,大大方便了我们的写作。例如此文从内容到格式,甚至插图,一个键盘可以搞定了,无需鼠标!

  目前来看,支持 Markdown 语法的编辑器有很多,包括很多网站(例如简书)也支持了 Markdown 的文字录入。Markdown 从写作到完成,导出格式随心所欲,你可以导出 HTML 格式的文件用来网站发布,也可以十分方便的导出 PDF 格式,甚至可以利用 CloudApp 这种云服务工具直接上传至网页用来分享你的文章,全球最大的轻博客平台 Tumblr,也支持 Mou 这类 Markdown 工具的直接上传。

  目前,我们的 博客园 同样支持了Markdown文本的编辑,具体如何设置请往下看!

Markdown特点

  • 专注你的文字内容而不是排版样式;
  • 轻松的导出 HTML、PDF 和本身的 .md 文件;
  • 纯文本内容,兼容所有的文本编辑器与字处理软件;
  • 可读,直观。适合所有人的写作语言。

教程

简明教程:

  • http://wowubuntu.com/markdown/basic.html

详细教程

  • http://wowubuntu.com/markdown/index.html

博客园配置Markdown编辑器

  1. 进入博客后台
  2. 点击“设置默认编辑器”
  3. 选中 Markdown并保存
  4. 回到随笔界面点击“添加随笔”
  5. 在“Markdown编辑器”中输入相应的代码
    第一步
    第二步

语法

1. 标题

标题通过 # 的个数来进行区分,Mardown总共支持6级标题。
标题

2. 段落 & 换行

2.1. 首行缩进/空格:

  •  : 英文空格(半角)
  •  : 中文空格(全角)
  • 输入法切换至全角,双击 空格 「推荐」
  • 半方大的空白  &#8194
  • 全方大的空白 &#8195
  • 不断行的空白格  &#160

2.2. 强制换行

  连续的字符串,如果你想要换行,往往打“Enter”是不管用的,正确的换行方法为在 「在需要换行的地方插入 >=2 个 空格」

2.3. 空行

两种方式:

  • 在markdown中加入 >=2 个空行.
  • 使用<br> 【推荐】
      
    mark

3. 列表

在Markdown下,有四种列表:有序和无序;

  • 有序列表:采用 1. 2. 3.的形式
  • 无序列表:采用前面加 * - + 的方式,支持多级嵌套
  • 未完成列表:- [ ],每个符号间均有空格
  • 已完成列表:- [x],注意空格使用
    PS: 符号与文字之间必须有 空格

mark
mark

4. 引用 (Quote)

若需要引入有出处的一段话等,可以采用引用的方式实现,实现方式为在行开始处加入>,如下所示:
mark

5. 字体设置

  • 粗体
    字符串前后均加上 **
  • 斜体
    字符串前后均加上 *
  • 删除线
    字符串前后各加 ~~
  • ++下划线++
    字符串前后各加 ++
  • == 字体背景色 ==
    字符串前后各加 ==
  • 标记
    字体前后加上 ` (Esc下方的那个键)

mark

6. 分割带

当上下文不属于同一模块或者无甚关联时刻,可以使用分隔符进行隔开;分隔符的格式如下:

  • 连续多个-(>=3)
  • 连续多个*(>=3)
  • 连续多个下划线 _ (>=3)
  • PS:以上,分隔符中间可以有空格,但分割行不可有其它字符存在

mark

7. 图片和链接

  • 图片
    ![]() : [图片名称] (图片网络地址)
  • 链接
    []() : [链接名称(可自定义)] (链接地址)

8. 代码块

和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示,Markdown 会用制表符来将代码包起来。
代码块一直持续到没有缩进的那一行(或是文件的结尾)

    #include <iostrem>  using namespace std;  int main(int argc, char **argv)  {cout << "hello,world!";}

mark

9. 网址自动转换

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是<>包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:

这个是我的博客地址:https://home.cnblogs.com/u/Jimmy1988/
我的邮箱地址是:JimmyNie2017@163.com

mark

10. 转义

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果,你可以在星号的前面加上反斜杠:

*literal asterisks*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号

11. 生成目录

  • 前提条件:

    标题的建立是采用MD格式实现的,目录的生成建议放在文本最开始部分(当然也可以嵌入在文中)。

  • 语法

    [TOC],中间不要有空格

  • 注意事项

    目录的生成并不是每个编辑器都支持的,至今我用过的编辑器 有道云笔记是支持的。

mark

12. 表格

mark
表格的做法通常为:

header 1 | header 2
--- |---
row 1 col 1 | row 1 col 2
row 2 col 1 | row 2 col 2

可用`<br>进行单元格内换行; 但是暂时不支持合并单元格


工具推荐

windows平台

  • Markdown Pad
  • Markpad

Linux平台

  • ReText

Mac平台

  • Markable.in
  • Dillinger.io

浏览器插件

  • MaDe(chrome)

在线编辑器

  • 麻花:支持在线编辑,关键支持VIM命令

高级应用

  • Sublime Text3 + Markdown Editor + 教程

更多工具

  • http://www.williamlong.info/archives/4319.html

mark

转载链接:http://www.cnblogs.com/Jimmy1988/p/7053875.html

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/538364.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

wdm设备驱动程序开发pdf_DWDM是什么 DWDM相关设备功能介绍【图文】

WDM/DWDM技术,什么是WDM/DWDM技术波分复用(WDM)是将两种或多种不同波长的光载波信号(携带各种信息)在发送端经复用器(亦称合波器&#xff0c;Multiplexer)汇合在一起&#xff0c;并耦合到光线路的同一根光纤中进行传输的技术;在接收端&#xff0c;经解复用器(亦称分波器或称去复…

团队作业8—团队项目用户验收评审

一、源代码管理的10 个实践问题&#xff1a; 1. 你的团队的源代码控制在哪里&#xff1f;用的是什么系统&#xff1f;如何处理文件的锁定问题&#xff1f; 我们团队项目的源代码在GitHub上托管&#xff0c;用git控制代码版本&#xff0c;我们用的是win10系统。在这个项目上&…

Android中已经添加权限,依然提示缺少权限,此时你需要添加动态权限

原文链接&#xff1a;http://blog.csdn.net/android_hdh/article/details/52583557 ------------------------------- 最近在开发项目时&#xff0c;项目需要获取系统的WRITE_EXTERNAL_STORAGE权限&#xff0c;然后就在清单文件AndroidManifest中添加了该权限&#xff0c;但是…

linux php任务计划,linux系统怎么添加计划任务执行php文件

linux系统怎么添加计划任务执行php文件linux系统怎么添加计划任务执行php文件?PHP不支持多线程,有时候处理问题不是那么爽,小编以php文件为例&#xff0c;讲解linux下的计划任务。linux系统添加计划任务执行php文件方法1.打开linux系统命令行界面。在命令行界面中输入如下命令…

windows server 2008 r2 定时关机_电脑怎么定时关机 秒懂的Win10定时关机命令使用方法...

Win10怎么定时关机&#xff1f;今天芝麻科技网教大家3种Win10定时关机方法&#xff0c;包含用命令定时关机、软件以及杀毒工具定时关机等&#xff0c;也适合XP、Win7和Win8等系统&#xff0c;相信对于一些如夜间下载东西或者大文件&#xff0c;挂机等用户有所帮助。方法一&…

Android-循环访问网站App

网优同事的突然需求。 花了1天开发了出来。 App截图 App操作流程 1、赋值要循环访问网站的地址 2、设置每次循环间隔时间和每次访问间隔时间 3、点击按钮开始访问 下载地址&#xff1a;https://download.csdn.net/download/zengmingen/9983519

与专门团队一起持续交付

BCG Digital Ventures的首席工程师Robin Weston 最近在伦敦持续生命周期大会&#xff08;Continuous Lifecycle London&#xff09;上发布了一份经验报告&#xff0c;在该报告中称&#xff0c;外部支持团队能够在难以实施变化的组织和封闭的团队中引入持续交付(CD)实践。该团队…

windows版一键绕id工具_Windows免费版一键绕过IOS13.6激活锁工具XgRiNdA,完美重启!...

支持iOS13.6.1系统&#xff0c;支持iPhone、iPad绕过&#xff0c;支持MEID三网、两网GSM机器&#xff0c;只要一键就可以绕过&#xff0c;可以完美关机重启&#xff0c;并且支持iTunes同步、爱思安装软件。新版本&#xff1a;增加屏幕锁/停用绕过解信号功能、新增12.4~13.2.3绕…

Could not find artifact

用Maven install 对父工程安装到本地仓库

uart怎么判断帧错误_UART通讯总线工作原理的理解

奥的斯电梯OCSS/LCBII /TCBC/GECB板与电梯轿厢和电梯井道之间的串行通讯采用了UART通讯&#xff0c;将井道和轿厢的输入、输出和开关部件的信号转换成串行通讯信号传输给电梯操作控制系统&#xff0c;大大节省了现场布线&#xff0c;下面就UART通讯总线工作原理的理解予以描述。…

matlab 光谱噪声,环境小卫星高光谱影像条纹噪声去除程序IDL版

前言源代码PRO stripe_remove1ENVI,/Restore_Base_Save_FilesENVI_Batch_initfile DIALOG_PICKFILE(/READ, FILTER *.img)print,fileENVI_OPEN_FILE,file,r_fidfidENVI_FILE_QUERY, fid, dimsdims, nsns, nlnl, nbnbprint,fid,dims,ns,nl,nbfdata fltarr(ns,nl,nb)datafltar…

启动TOMCAT报错 java.util.zip.ZipException: invalid LOC header (bad signature)

报错信息大致如下所示&#xff1a; at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)at java.lang.reflect.Method.invoke(Unknown Source)at org.apache.catalina.startup.Bootstrap.start(Bootstrap.java:303)at org.apache.catalina.startup.Bootstrap.…

结构体怎么赋值_c语言学习之基础知识点介绍:结构体的介绍

一、结构体的介绍/* 语法&#xff1a;struct 结构体名{成员列表;};切记切记有分号&#xff01;说明&#xff1a;成员列表就是指你要保存哪些类型的数据。注意&#xff1a;上面的语法只是定义一个新的类型&#xff0c;而这个类型叫做结构体类型。因为类型不能保存数据&#xff0…

阿里云Maven仓库地址

<默认情况下配置多个mirror的情况下&#xff0c;只有第一个生效&#xff0c;只有当前一个mirror 无法连接的时候&#xff0c;才会去找后一个&#xff1b;而我们想要的效果是&#xff1a;当a.jar在第一个mirror中不存在的时候&#xff0c;maven会去第二个mirror中查询下载&a…

php怎么使得字体滚动,滚动文字+字体特效代码(全集)

收集了几天&#xff0c;终于把滚动文字*字体特效差不多收集完了&#xff0c;这里与大家一同分享&#xff0c;期待您的博客越做越漂亮&#xff01;感谢您的光临&#xff01;1.阴影滚动字循环滚动:欢迎光临弥勒内院看门人博客&#xff0c;看门人欢迎您代码:欢迎光临弥勒内院看门人…

Eclipse集成svn后出现Failed to load JavaHL Library的解决办法

在win10 64位上eclipsex64位 集成svn插件 在使用 Team-share project &#xff0c;选择svn后&#xff0c;报了&#xff1a;Failed to load JavaHL Library错误 解决方法&#xff1a; winodws--perference--svn。设置如下图

php如何打出的正方形行列,javascript实现输出指定行数正方形图案的方法

本文实例讲述了javascript实现输出指定行数正方形图案的方法。分享给大家供大家参考。具体如下&#xff1a;javascript实现输出指定行数的正方形图案&#xff1a;点击生成图案&#xff0c;会有2个提示框&#xff0c;1&#xff0c;输入图案的组成字符&#xff0c;只能是1个字符哦…

eclipse的SVN插件设置忽略文件

windows--preference--Team-ignore resource 这里我新增了maven项目常不需要提交应该忽略的文件和文件夹 文件&#xff1a; .setting .project .classpath 文件夹&#xff1a; */target/* */target */settings */settings/*

postgresql 插入 时间戳_数据也玩躲猫猫?PostgreSQL中别人提交的数据,我为什么看不到?...

原创&#xff1a; Aken DB印象文章链接&#xff1a;https://mp.weixin.qq.com/s/OkJaWbzcXcJtzSCOFnqeXQ文章作为DB的学习体会&#xff0c;若有错误欢迎指导。一、环境介绍操作系统&#xff1a;CentOS Linux release 7.6.1810 (Core) DB版本&#xff1a;PostgreSQL -11.5 on x8…

VMware打卡虚拟机提示“此虚拟机可能已被复制或移动”

“我已移动虚拟机” //表示打开后的虚拟的网卡的mac地址不变&#xff0c;如果复制本地的&#xff0c;同时开机在一个vmnet可能造成冲突。 “我已复制虚拟机” //表示打开后的虚拟机的网卡的物理地址是新生成的&#xff0c;建议不懂的就选这个。 “取消” …