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

Posted petewell

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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 使用中常见的问题及解决方法


以上是关于Markdown 使用中常见的问题及解决方法的主要内容,如果未能解决你的问题,请参考以下文章

jforum二次开发中常见问题及解决方法

Node 项目中常见的问题及解决方法

Node 项目中常见的问题及解决方法

Node 项目中常见的问题及解决方法

markdown 放代码片

Navicat使用常见的两个问题及解决方法,提高开发效率