Markdown 使用中常见的问题及解决方法

就像 Markdown 官方文档里描述的一样:可读性,无论如何,都是最重要的。 Markdown 的目标是实现 ? 『易读易写』 。?Markdown 从发布到现在备受好评,经过这一段的使用,整体感觉挺顺手,不过还是存在很多问题,所以总结一下喽。。

编辑器

其实自己喜欢的才是最好的。(像 vim 、emacs什么的不推荐,因为我也不会用)

MAC平台

自己没用过,不做推荐。你可以看看这个帖子:Mac 上适合码农用的 Markdown 编辑器是什么?

Windows平台

印象笔记

马克飞象传送门,界面不是很好看,书写的时候感觉很别扭

有道云笔记

有道传送门,同样很丑,强迫症受不了

Sublime Text

强大的 Sublime Text 总是能给我们很多惊喜,经过各种对比,sublime 满足了我对审美的要求。首先我们需要安装两个插件:(至于怎么安装就不说了)

  • markdownEditing 用来书写
  • markdownPreview 用来预览

Atom(强烈推荐)

GitHub 推出的编辑器,界面很好(就是启动有点慢),必须支持一下。默认继承了 markdown 预览,快捷键为 Ctrl+shift+M。推荐插件:

  • markdown-preview 实时预览
  • markdown-scroll-sync 编辑区和预览区同步滚动
  • markdown-writer 方便管理图片链接等
  • markdown-table-formatte 表格格式化

使用方法

Markdown官方文档

常见问题汇总

html标签显示

比如说我要写一篇博客,标题为“html中 <canvas> 的使用”

1
## html中 <canvas> 的使用

如果这样写就会出现排版上的问题(不信你试一下),那么怎么解决呢?其实认真想一下就能明白,Markdown 的语法是基于 html 的,我们直接写 <canvas>,自然会被理解为一个标签,而不是要显示的文本。。所以,问题回归到 html 上。在网页中,我们要显示 <canvas> 时要用到 转义字符, 所以 Markdown 中也一样,我们应该这样写:

1
## html中 &lt;canvas&gt; 的使用

代码语法高亮

这个问题困扰了我好久,官方文档里竟然没有说明!只好自己去查找方法。Markdown 中显示代码块是这样的格式:

显示为:

1
<p>这是一个p标签</p>

而我们这样写:

就可以实现代码高亮了

1
<p>这是一个p标签</p>

据说这种方式一共支持四十多种语言,有兴趣的话你可以研究一下。

图片

Markdown 中嵌入图片,如果使用本地图片就要用到 html 标签来引用,这种方法很稳定,但是使文档变得很大(一张图片最少几百k吧)。所以我们要用到 图床

贴图库

推荐使用 ? 贴图库 ?快速,免费(我使用过程中没掉过链子)

注册登录,就可以上传图片,每张图片自动生成 原图展示图缩略图图片外链html代码Markdown外链等。只要把对应的代码粘贴到你的文档中就可以了。。

七牛云存储

这个最近很火,可靠、可扩展、低成本等等有很多优点。你可以试一下。
我们主要用到他的 对象存储 服务,创建一个公开仓库,把图片上传就可以生成外链了。

gif

Github 上的开源项目,ReadMe.md 是也支持 Markdown 语法的,通常会看到很多开源项目的 ReadMe 中有 动态演示效果,看到这个项目的人一目了然,非常方便,gif本身也是一种图片格式,在 Markdown 中 引用时和正常图片的引用一样,但需要专门的工具生成 gif 格式的图片才行,在这里强烈推荐 LICEcap,它是一款 windows 上的录屏软件,录制后保存的格式为 gif,体积小并且同样也可以在图床上生成链接。

插入音乐

你可以把音乐文件下载到本地,然后简单粗暴的使用 html 中的 <video> 标签。当然,如果这样就不必写下去了,告诉你简单的方法:网易云音乐

打开网易云音乐网页版,搜索自己喜欢的音乐,比如我找到 告白气球


我们可以看到在图片的下边有一个 生成外链播放器 , 点击会出现


选择 合适的尺寸播放模式 之后。把下边的代码复制到你的 Markdown 文档中就可以了。试着听一下吧!!(我选择了最小尺寸)

试着去把一个 歌单生成外链播放器 插入到你的 Markdown 中,这样你跟新歌单你的博文也会跟着变化,而不必在想跟换歌曲时头疼

原文:大专栏  Markdown 使用中常见的问题及解决方法

原文地址:https://www.cnblogs.com/petewell/p/11601713.html

时间: 2024-10-09 16:44:09

Markdown 使用中常见的问题及解决方法的相关文章

coreseek常见错误原因及解决方法

coreseek常见错误原因及解决方法 Coreseek 中文全文检索引擎 Coreseek 是一款中文全文检索/搜索软件,以GPLv2许可协议开源发布,基于Sphinx研发并独立发布,专攻中文搜索和信息处理领域,适用于行业/垂直搜索.论坛/站内搜索.数据库搜索.文档/文献检索.信息检索.数据挖掘等应用场景,用户可以免费下载使用 本文为大家整理了coreseek/sphinx中文检索引擎的常见问题和解决方法,感兴趣的同学参考下. Coreseek 是一款中文全文检索/搜索软件,以GPLv2许可协

LAMP系列之PHP编译过程中常见错误信息的解决方法

LAMP系列之PHP编译过程中常见错误信息的解决方法 在CentOS编译PHP5的时候有时会遇到以下的一些错误信息,基本上都可以通过yum安装相应的库来解决.以下是具体的一些解决办法: ******************************************************************************* checking for BZip2 support- yes checking  for BZip2 in default path- not foun

magento常见的问题及解决方法

刚接触magento时,会遇到很多问题,大多数都是些magento配置及操作上的问题,因为刚接触magento不久所有对这些问题比较陌生也不知道如何处理.今日根据模版堂技术指导下和网上的相关例子,这里罗列了一些操作Magento常见的报错问题解决方法? 后台首页出现404错误 >查看模版是否没有 查看后台—系统配置—设计配置的模版 >因为在/etc/local.xml中修改过后台入口的路径 而后登录后台成功后 报404错误 查看后发现后台的新路径前面总是加了默认的管理入口admin 例如:ht

机器学习中常见的过拟合解决方法

在机器学习中,我们将模型在训练集上的误差称之为训练误差,又称之为经验误差,在新的数据集(比如测试集)上的误差称之为泛化误差,泛化误差也可以说是在模型在总体样本上的误差.对于一个好的模型应该是经验误差约等于泛化误差,也就是经验误差要收敛于泛化误差,根据霍夫丁不等式可知经验误差在一定条件下是可以收敛于泛化误差的. 当机器学习模型对训练集学习的太好的时候(再学习数据集的通性的时候,也学习了数据集上的特性,这些特性是会影响模型在新的数据集上的表达能力的,也就是泛化能力),此时表现为经验误差很小,当往往此

FindBugs常见错误描述和解决方法

(一)[DLS_DEAD_LOCAL_STORE]描述: Dead store to 未使用的局部变量解决方法:局部变量定义后未使用:实例化对象后又重新对该对象赋值 (二) [ST_WRITE_TO_STATIC_FROM_INSTANCE_METHOD] 描述:Write to static field 通过实例方法更新静态属性常见于常量类,直接通过类名.常量名获取的方式违背了封装的原则,findbugs不提倡使用,而如果将常量改成静态成员变量,又因为spring不支持静态注入导致不能实现,解

【集群实战】NFS服务常见故障排查和解决方法

NFS,全名叫Network File System,中文叫网络文件系统,是Linux.UNIX系统的分布式文件系统的一个组成部分,可实现在不同网络上共享远程文件系统. NFS由Sun公司开发,目前已经成为文件服务的一种标准之一(RFC1904,RFC1813). 其最大的功能就是可以通过网络,让不同操作系统的计算机可以共享数据,所以可以把NFS看做是一个文件服务器.NFS缺点是其读写性能比本地硬盘要差一些. 一.NFS服务常见故障排查: NFS服务出现了故障,主要从以下几个方面检查原因: (1

JS高程中的垃圾回收机制与常见内存泄露的解决方法

起因是因为想了解闭包的内存泄露机制,然后想起<js高级程序设计>中有关于垃圾回收机制的解析,之前没有很懂,过一年回头再看就懂了,写篇博客与大家分享一下. #内存的生命周期: 分配你所需要的内存: 由于字符串.对象等没有固定的大小,js程序在每次创建字符串.对象的时候,程序都会分配内存来存储那个实体. 使用分配到的内存做点什么. 不需要时将其释放回归: 在不需要字符串.对象的时候,需要释放其所占用的内存,否则将会消耗完系统中所有可用的内存,造成系统崩溃,这就是垃圾回收机制所存在的意义. 所谓的内

Laravel中常见的错误与解决方法小结

一.报错: 「Can't swap PDO instance while within transaction」 通过查询 Laravel 源代码,可以确认异常是在 setPdo 方法中抛出的: ? 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 <?php public function setPdo($pdo) {   if ($this->transactions >= 1) {     throw new RuntimeException("

CentOS编译PHP过程中常见错误信息的解决方法

原文链接:http://www.linuxidc.com/Linux/2014-05/102327.htm ******************************************************************************* checking for BZip2 support- yes checking for BZip2 in default path- not found configure: error: Please reinstall the