当前位置:首页 » 编程软件 » markdown编译

markdown编译

发布时间: 2022-08-01 11:50:37

① 写好的Markdown怎么生成HTML

3个步骤
1、task ‘generate’
把README.md编译成html,并带有左侧目录功能。
这里使用tocmd命令(tocmd 是一个ruby gem,用于把markdown文件生成带有toc目录的html文档。)
tocmd_conf -f README.md

如果你本机没有安装的话,可以根据https://github.com/i5ting/tocmd.gem里的文档里安装方法
gem intall tocmd

前提是你一定要ruby2.0以上的环境哦。
2、task ‘rename’
这步主要是,上一步生成的文件是README.md,而静态网站使用的是index.html,所以需要重命名。
这里简单的把./preview/README.html文件复制为./preview/index.html
cp ./preview/README.html ./preview/index.html

3、task ‘deploy’
把./preview/**/*目录的内容推送到git仓库的gh-pages分支上。
这里主要使用gulp-gh-pages插件,它是会把指定目录的内容推送到git仓库的gh-pages分支上。
利用git pages静态http server的特性可快速建立网站。
var gp_deploy = require('gulp-gh-pages');

var options = {}
gulp.task('deploy', function () {
return gulp.src('./preview/**/*')
.pipe(gp_deploy(options));
});

② hexo 怎么使用markdown

Markdown
hexo是使用Markdown编辑文章的,我写的这些文章也都是用这种标记语言完成的。所以我们先从Markdown说起。
什么是Markdown
Markdown语法
例文
你可以使用vim工具直接编辑md文件,也可以用记事本打开md文件编辑你的文章,也可以Markdown的编辑器编写,有很多在线的编辑器,何有不少客户端的编辑器,我是Mac系统,用的一个叫Mou的编辑器,还比较好使。Windows系统下,你可以自己找一下,应该也会有很好用的编辑器。
什么是Markdown
Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯和亚伦·斯沃茨。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML文档”。 ——维基网络
先简单介绍一下,Markdown的语法,具体怎么用,我相信大家一看例文就马上明白了。
Markdown语法
1、分段: 两个回车
2、换行 两个空格 + 回车
3、标题 #~###### 井号的个数表示几级标题,即Markdown可以表示一级标题到六级标题
4、引用 >
5、列表 *,+,-,1.,选其中之一,注意后面有个空格
6、代码区块 四个空格开头
7、链接 [文字](链接地址)
8、图片 ![图片说明](图片地址),图片地址可以是本地路劲,也可以是网络地址
9、强调 **文字**,__文字__,_文字_,*文字*
10、代码 ```,``
下面来看看例文,你就马上明白,怎么来使用这些符号来写好一篇自己的博文了。
例文
在线编辑器例文:传送门
Mou编辑器:下载地址
你先试试,用Markdown怎么去些自己的文章,有了例子,还是很容易上手的。
hexo常用命令
我们在前面的已经略微的接触了一些hexo的命令,如hexo new "my blog",hexo server等。下面来介绍一下我们经常会用到的hexo命令
1、新建
hexo new "my blog"

新建的文件在hexo/source/_posts/my-blog.md
2、编译
hexo generate

一般部署上去的时候都需要编译一下,编译后,会出现一个public文件夹,将所有的md文件编译成html文件
3、开启本地服务
hexo server

这个命令,我之前已经用过了,开启本地hexo服务用的
4、部署
hexo deploy

部署到git上的时候,需要用这个命令,下一篇中,我们会使用到这个命令
5、清除public
hexo clean
当source文件夹中的部分资源更改过之后,特别是对文件进行了删除或者路径的改变之后,需要执行这个命令,然后重新编译。
以上这些都是我在使用过程中经常用到的一些hexo命令。

③ markdown适合制作出版物吗

因为Markdown毕竟还是部分程序员与少部分作家/编辑才熟悉的格式,而大多数人依然喜欢 WYSIWYG 的编辑器

另外,Markdown作为编辑器出现时还会有更多的麻烦,比如他需要编译后才能作为格式化文本进行查看、而且本身没有很多富文本所通用的特性,比如字号大小、字体颜色等等。

所以,Markdown更适合的土壤大概依然是纯粹的技术文档或是文字生产者,而不是更通用的情况,那么大多数的发布工具不去进行支持也相当能理解了。

P.S. 我更常用的做法是写了Markdown后在Gist上发布与微调,之后直接将格式化后的文本贴到其它文本编辑器里,进行最后调整格式后发布。

④ markdown常用语法

1. 标题

第一种是使用#表示标题,其中#号必须在行首,
第二种是使用===或者---表示。

2. 分割线

使用三个或以上的-或者*表示,且这一行只有符号,注意不要被识别为二级标题即可,例如中间或者前面可以加空格。

3. 斜体和粗体

使用*和**分别表示斜体和粗体,删除线使用两个~表示

4. 超链接和图片

链接和图片的写法类似,图片仅在超链接前多了一个!,一般是 [文字描述] (链接)

5. 无序列表

使用-、+和*表示无序列表,前后留一行空白,可嵌套,

6. 有序列表

使用1.(点号后面有个空格)表示有序列表,可嵌套。

7. 文字引用

使用>表示,可以有多个>,表示层级更深,

8. 行内代码块

其实上面已经用过很多次了,即使用 ` 表示,例如

扩展:很多字符是需要转义,使用反斜杠进行转义

9. 代码块

使用四个空格缩进表示代码块,一些 IDE 支持行数提示和着色,一般使用三个 ` 表示,

流程图

主要的语法为name=>type: describe,其中 type 主要有以下几种:
1.开始和结束:startend
2.输入输出:inputoutput
3.操作:operation
4.条件:condition
5.子程序:subroutine

数学公式


使用 $ 表示,其中一个 $ 表示在行内,两个 $ 表示独占一行。


eg : $sum_{i=1}^n a_i=0$


支持 LaTeX 编辑显示支持,访问 MathJax 参考更多使用方法。


推荐一个常用的数学公式在线编译网站:https://private.codecogs.com/latex/eqneditor.php


13.支持 HTML 标签


例如想要段落的缩进,可以如下:


  不断行的空白格 或 

  半方大的空白 或 

  全方大的空白 或 


⑤ 有什么支持LaTeX公式显示的Markdown编辑器吗

就我而言并没有听说过。个人认为,Markdown 的方式对于编辑器对于 LaTeX 似乎没有什么帮助。不管你在编辑器中的 LaTeX 排版的多好,生成pdf也不会受到影响的。因此编辑器能够提供语法高亮、段落缩进和段落注释,我觉得就够了。

Markdown中可以插入 LaTeX,但是专门的编辑器并没有听说。我也认为 LaTeX 的编译模式足够优秀,命令输入清晰,似乎没有使用 Markdown 的必要需求。

⑥ Textile 和 Markdown 各有什么优劣

Markdown 和 Textile 都是如今轻量级标记文本风潮下的产物,基本设计思路差异不大,所以我不打算纠技术细节。有兴趣者请参考我文后的链接。以下我只说一些个人的感受。

先声明,这两者都不是我的首选工具,只是之前选择时比较过。所以结果可能不完善。如有不同意见请与我联系,要求删贴也无妨。

=== Markdown 的优点 ===
Markdown 的主要优点是有大量的第三方编辑器支持。首先 GitHub 的在线文档编辑器就能很好地支持它,而 Mac App Store 或 Windows Marketplace 上搜索 Markdown editor 也是一抓一大把。很多编辑器都支持所见即所得编辑,非常方便。相比之下支持 Textile 的编辑器数量就很少。但 Markdown 在做复杂的内容编辑时能力有限,要求编写者最好具备一定的 HTML 基础,比如插入表格。对不熟悉 HTML 的朋友来说,这种操作未免麻烦了些。

——但需要注意的是,这不算是 Markdown 的问题,而是设计者有意为之的。本来 Markdown 的设计目的是为了“简化”而非“替代”HTML。

=== Textile 的优点 ===
Textile 的优势是不需要过多的 HTML 基础(当然如果确实需要,用户也可以用)。比如表格,它提供了 [Table] 标志而不是要求直接上 HTML 段落;又比如 == 号可用来阻止解释器解释,而不是像 Markdown 那样需要直接用 <div>。Textile 的另一个好处是它提供了一些复杂字符的内建支持,比如:(r) == ®, (tm) == ™, (c) == ©,放在 Markdown 里就麻烦一些。第三个好处,也是我很喜欢 Textile 的一点:它提供的标记更容易阅读。比如标题标记,Textile 用 .h1 .h2,级别一目了然,和 Markdown 用“#”和“##”的标识相比,可读性更好。

=== 一些共同的特性 ===
如果把讨论限制在方便性上,Textile 和 Markdown 只能说各有千秋。比如在处理逐条记录(itemization)时 Textile 统一用“#”,而不像 Markdown 那样要求使用 1,2,3,4。应该说 Textile 的设计便于用户变更条目顺序时避免多处修改;反过来,Markdown 处理脚注时可以使用无记名脚注,而 Textile 则必须使用 [1] 和 fn1 的组合。如果脚注顺序需要修正则会麻烦许多。

---- 得 @Jesse Luo 指点:Markdown 的逐条记录可以在编译时自动将 11223调整为12345,所以不要误会,Markdown 事实上可以相对方便地处理逐条记录。特此感谢。不过如果为了照顾纯文本的可读性,写作者最好还是得在正文里调整数字的顺序。这一点上看,Textile 还是方便。

如果把讨论限制在功能上,我只能说两者都不怎么样。这两者都适合相对非正式的文本,比如 blog 或网页。两者相对单一的 HTML 输出也证明了这一点。如果需要更复杂的功能,恐怕用户还得考虑更复杂的选项,比如我用得最顺手的 reStructuredText。

综合考虑,我倾向于认为 Textile 更适合我这种 HTML 基础较差的用户;而 Markdown 在前端程序员手里适应性更好。另外,对“所见即所得”有要求的朋友可能会在编辑器支持的问题上有所倾向。但既然这些都是纯文本编辑,多数情况下我不认为这一点非常重要,毕竟对我来说,一个 vim 足以解决所有问题。

⑦ marked.js是什么来的怎样使用

marked.js是一个用JavaScript写的功能齐全的Markdown解析器和编译器。可以非常方便的在线编译Markdown代码为HTML并直接显示,并且支持完全的自定义各种格式。

使用案例:
var marked = require('marked');console.log(marked('I am using __markdown__.'));// Outputs: <p>I am using <strong>markdown</strong>.</p>

var marked = require('marked');marked.setOptions({ renderer: new marked.Renderer(), gfm: true, tables: true, breaks: false, pedantic: false, sanitize: false, smartLists: true, smartypants: false});console.log(marked('I am using __markdown__.'));

<!doctype html><html><head> <meta charset="utf-8"/> <title>Marked in the browser</title> <script src="lib/marked.js"></script></head><body> <div id="content"></div> <script> document.getElementById('content').innerHTML = marked('# Marked in browser\n\nRendered by **marked**.'); </script></body></html>

⑧ 开源中国的markdown编译器开源吗

它的效果跟SF使用的编辑器类似,区别是几个标记语法有些不同。 它可以运行于浏览器和服务器端(NodeJS). 我这几天试用了一下。感觉还不错。功能跟sf的基本一致。 ============== MD2HTML 我只使用了Java版本的MarkdownJ。

⑨ 怎么把Markdown文件转换为PDF

只要是可以打印,就可以使用虚拟打印机来处理:方法一:使用虚拟打印机pdf factory即可,而且其他格式文件只要是能够打印,选择这个虚拟打印机,都可以做成PDF文件,很简单实用;方法二:用其他虚拟打印机转成PDF文件。方法三:使用专门的转换软件,把文件转成PDF文件。实在不能打印,还可以截屏嘛,然后按照下面的方法做出PDF的:方法一:使用虚拟打印机pdf factory即可,而且其他格式文件只要是能够打印,选择这个虚拟打印机,都可以做成PDF文件,很简单实用;方法二:使用FreePic2Pdf软件,进行批量转换;方法三:用其他虚拟打印机转成PDF文件。Windows下安装pandoc很容易,直接从pandoc官网上下载最新安装包安装即可。Linux下的安装可以参考阳志平的博文1。pandoc被称为格式转换的瑞士军刀2。执行程序文件只有20M左右大小,但是能够在几十种文件格式之间自如的转换,那当然是得依赖各种格式文件所需要库。转换为pdf就要用到MiKTeX,Windows下推荐使用CTeX完整版,对中文的支持很好,可以从CTeX官网下载完整套件。如果markdown文件中不包含中文字符,那么直接使用下面的命令就可以将markdown文件无缝转换为Latex支持的pdf文件。如果markdown文件中包含中文字字符,那么上段命令就无法直接转换,可能会报以下错误:为了解决中文编译的问题,需要做以下的工作:将markdown文档的编码方式改为utf-8。比较简单的办法就是用记事本打开该文档,然后另存为时选择编码方式为utf-8。有可能当你改变编码方式后,文档中的中文全变成乱码了。为避免这种情况,可以在改变编码方式之前先复制文档的全部内容,然后在改变编码方式之后粘贴替换文档中的全木内容,这样就不会出现乱码了。编译pandoc默认的latex引擎是pdflatex,是不支持中文的,因此需要手动设置编译时所用的引擎为xelatex,编译命令改为:这时编译可能没有错误了,但是得到的pdf文档中可能所有的中文都没有了。这是字体的问题,因为编译时默认的字体时不支持中文的,所以我们得手动设置中文字体。显然,所设的字体应该为系统中已装的字体,且字体的名字不能写错。有一个办法可以的到系统中所安装的所有字体名(见博文),即在控制台中输入命令:fc-list >> C:\fonts.txt。这样,扫到的字体信息就全部被导入到C盘根目录下的fonts.txt文件中了。这里我们选择宋体,字体名称为“SimSun”,于是编译命令改为:这里字体名也可以不加双引号,但是如果字体名比较复杂(如包含空格)时,不加双引号就可能出错。好了,中文字符应该能够显示了,但是你可能会发现很多文字已经超出了文档的边界无法显示了,这是因为pandoc对中文的支持不太好,不能自动换行。但是这并不表示pandoc就真的无法完美处理中文文档了,因为技术界那些追求完美的极客们为我们提供了无限的可能。这篇博文介绍了pandoc中文pdf转换攻略3,解决方案是使用网友编辑好的latex模板来生成pdf,这里用到的是tzengyuxio提供的pm-template.latex4。 下载模板后将其中的LiHei Pro字体替换成系统中安装有的中文字体即可,然后编译命令改为:注意:如果安装的MiKTeX(我用的是CTex)宏包不全,编译可能会出问题,如找不到exp13.sty等,因此推荐安装完整版的MiKTex。当然,你也可以使用自己定义的模板来生成tex和pdf文件。首先使用命令 pandoc -D latex > my.latex 生成一个默认的模板,在对这个模板进行修改,如字体、自动换行等。

热点内容
androidlistview点击事件 发布:2025-02-09 07:25:52 浏览:171
targz解压缩 发布:2025-02-09 06:59:19 浏览:311
wpsphp 发布:2025-02-09 06:58:41 浏览:961
视易锋云系统如何架设辅助服务器 发布:2025-02-09 06:47:08 浏览:769
mysql备份脚本shell 发布:2025-02-09 06:46:33 浏览:15
腾讯云服务器怎样调整分辨率 发布:2025-02-09 06:46:30 浏览:369
php上一个页面 发布:2025-02-09 06:41:25 浏览:489
改装配置后不想重启怎么办 发布:2025-02-09 06:36:40 浏览:446
算法复杂度定义 发布:2025-02-09 06:30:46 浏览:587
昵图源码接口 发布:2025-02-09 06:30:37 浏览:725