如何将Markdown文件转换成HTML?

(1)利用 fs模块的文件监视功能fs.watch(filename,listener)监视指定markdown文件. (可以理解为发布模式,每当文件发生变化,发布消息,者收到消息)。

markdown文件(Markdown文件怎么加水印)markdown文件(Markdown文件怎么加水印)


markdown文件(Markdown文件怎么加水印)


markdown文件(Markdown文件怎么加水印)


(2)当文件发生变化后,借助 marked包提供的markdown to html 功能将改变后的md文件转换为html格式。

(3)将得到的html以及读入的css文件替换到模板,得到终要渲染的html。

(4)利用BrowserSync模块实现浏览器自动刷新,即每当改变markdown文件,浏览器中会自动刷新显示。

markdown文件生成目录的方式

markdown语法简单好上手,在项目中很多文档都是采用markdown语法完成的,以下介绍两种在markdown文档中自动生成目录的方式。

一、有道自动生成

在文章开始地方输入[toc],即可在对应位置插入目录

注意:凡是文章标题带有#(1-6个)的都会被捕获到目录中。

二、npm 语法生成

全局安装doctoc插件

如你的markdown文件在work/demo.md文件下,只需要cd work 切换到当前文件目录下,执行doctoc demo.md文件,即可在文档中自动生成目录。

三、两种方式的优缺点

1.有道生成目录

优点是:简单快捷,

缺点是:直接生成文字目录,没有生成相应的目录连接

2.npm doctoc生成目录

优点:生成了相应的目录连接(例如:文章段落一有地方要跳转到段落二,这时候有目录链接就很方便的完成跳转了)

缺点:依赖npm

关于Markdown的一点疑问,为什么很多人说markdown比word好用?

主要还是应用场景不同:

工具没有好坏之分,只有适不适用自己!markdown更适合于对格式要求不高、表格不复杂、较少的文章排版,比如一般的网络短文,在长文档,专业性要求较高的文档还是word有优势。

在这里我不想说Word, Markdown中那个更好,各自有各自的用户群体,和使用场景。大家都对Word比较熟悉,在这里我只介绍下Markdown,及其使用场景,特点和个人的使用感受。

Markdown是一种轻量标记语言,通过简单的语法,使普通文本具有一定的格式。印象笔记的Markdown拥有的一键新建入口,能让你双手不离键盘直接写出你想要的文字和排版,为用户提供了超高效的沉浸式写作体验。

我在项目中,一般都使用的Markdown,其实几乎所有的软件项目中的说明文档都使用的Markdown,极少有使用Word的,看看github上的项目的说明文档就知道了。Markdown给我的感觉好的地方有下面几点:

另外我们日常接触到的很多软件也都是用的Markdown,比如印象笔记,博客,哈希文档,Github,Stackoverflow,YAMI等。

Markdown编辑的文档给人的感觉十分清爽,下面我们看下一个markdown编辑的文件,

排版如下:

历史 版本:

某次 历史 修改:

工具的好坏需要结合实际使用场景来说。如果这个文档就你一个人维护,就存放在自己的电脑里,那么直接用word方便。但是如果多人维护一个文档,需要在页面展示你的文档内容这个时候md更合适。

md的场景程序员遇到的比较多,因为像github/gitlab这类代码管理仓库,就支持解析md,如果你在代码仓库创建readme.md,里面按md的语法写内容,那么github/gitlab可以直接对内容渲染展示。如果用word就无法实现这个效果。另外多人维护一个文档是,word文档在beyond ompare上不能很好的看出版本异。而md对beyondcompare来说可以按普通文本处理,就可以方便的看出版本异。

markdown对于我来说,经过2年的使用,已经不那么陌生了。我来回答一下markdown和word之间的这种区别。word的强大,毋庸置疑,但也因为她的强大,开始让很多的人开始思考,是不是每次写点东西,都要用到word?

写点东西的需求,有时候很简单,就是整理一下自己的思路,留下一段自己的想法,表达一些自己的观点,描述一段情景。很适合我们做知识笔记的场景。

抛开世间的凡俗,不在乎世人的眼光,我要的是“我需要的”的感觉。那么markdown也就成为了合理的选项!可以不顾及版式,因为markdown的版式已经很是不错。这就是用她的理由,没有那么多原因。

当然,你需要在正规的场合使用的文本,还是要遵循正规的场合要求,例如公司的,公司的通知或会议纪要,财务的报表,律师的函件,等等已经形成了严格的行文格式的情况时,你是不能使用markdown放飞自我的。

目前并不是所有人的电脑里都安装有markdown,所以目前word等办公软件仍是主流。

好与不好,看你如何用。不过时代是向前发展的,markdown的好,你只有用了才知道,不妨主动多多的尝试。对了,我现在写的这些,就是markdown下写的。感觉好极了!

markdown的编辑用文本编辑器就可以了,可以各个平台系统都可以一致性。无论是emacs、notepad、vim/nvim还是atom等等,都可以编辑,当然ms-word也可以编辑。

word文件(.doc/.docx)在linix下的开源软件格式并不能做到完全一致。不信可以试一试。

就是说编辑markdown可以随手随时随地,word则需要特定的工具才能完美(ms oword)。

markdown是可以导出各种格式,非常灵活。(word其实也可以,但是用的人不多)

makrdown 文件是纯文本文件,版本控制比较好做。

一个word/.docx 文件实际上是很多文件的一个包 ,这样版本控制就远不如markdown 方便。

本人是用emacs 的org-mode编辑,就是文件生成pdf,或者.doc或html之类。

我之前使用wiki语法,

markdown出现后,

转向了markdown,

markdown语法基本和wiki语法相似,但是更强大更科学一点。

目前wiki语法+markdown语法使用经验超过10年。

我使用markdown是因为:

再好的软件也得会使用才行,我电脑上现在使用的各种软件都是通过360安全卫士的软件管家来下载安装的 。

markdown和work都是工具,没有谁比谁好用之分。由于Markdown的轻量化、易读易写特性,并且对于,图表、数学式都有支持,许多网站都广泛使用Markdown来撰写帮助文档或是用于上发表消息。主要是markdown编写的文档容易在互联网发布,Github,Gitee,简书还能被使用来撰写电子书,markdown现在用户群应该是程序员。而Word已经是的文字处理程序,这个就不多说了。

文本编辑,

日常工作使用广泛的事儿

文本编辑器中

Word功能是强大

但是由于Word功能过分烦杂

工作效率就会降低

markdown是种高效的文本编辑模式

通过快捷键高效处理

文本编辑工作

markdown工具挺多

根据自己喜好搜索下载使用就可

markdown文件的目录树生成

近看 github 上项目,发现很多都有文档文件(README.md),看见里面有目录树,故而整理了一下。markdown文件的目录树生成的核心在于锚点。

ps:这里是不支持的,你要想加,可以参考 自动生成目录小工具 。

基本每个编辑器都有【目录生成】的功能。我用的 Typora ,我找了一下, 段落--内容目录 ,确实能生成目录树,效果还不错。切换成源码一看,只是加了个 [TOC] 。不支持,好像CSDN就支持 [TOC] 。

种 : 去此处 查看 README.md 文件。

截图如下:

第二种 : 去此处 查看 README.md 文件。

截图如下:

ps:这里,都不支持。

markdown可以重用吗

可以。

Markdown本身不支持内容重用。但是,没错这里说的就是但是,Gitbook提供内容重用的机制,来支持我们实现这个需求。Gitbook提供的内容重用机制有,变量,Gitbook中提供了定义变量,并在内容中引用这个变量的能力。在出版成PDF或者用户浏览网站的时候根据变量的值动态生成内容。在我们的内容中,有比较少的文字重复出现,而且根据情况会变化,比如,产品的名字。针对这种情况,我们可以定义一个变量,然后在内容中引用这个变量,从而达到重用的效果。

内容引用,Gitbook中提供了在一个Markdown文件引用另外一个Markdown文件的能力。在出版成PDF或者用户浏览网站的时候被引用的内容将被合并到文件中。在我们的内容中,有比较多的文字重复出现,比如,版权声明。针对这种情况,我们可以把重复出现的内容放在一个Markdown文件中,然后在其他Markdown中引用这个文件。

markdown文件怎么转换成html或者pdf文件

markdown文件转换成html或者pdf文件方法步骤如下:

1首先需要安装markdownPad软件,这是专门编辑和生成转换markdown文件为html或者pdf文件的软件,下载安装激活教程可以网上查找。

2然后把markdown文件用markdownPad软件打开。左边是源码右边是效果。

3然后点击菜单栏的“文件”,之后是“导出”,再选择导出的格式,可以看到有html和pdf两项。

4保存为html文件后,markdown文件可以直接用浏览器打开。

5保存为pdf文件后,markdown文件可以直接用pdf阅读器打开。