,GitHub Pages 将只支持 kramdown 作为唯一的 Markdown 引擎。...这其实也算得一件好事,之前支持 Rediscount、Redcarpet 和 kramdown 等多种引擎,而它们相互之间和与标准 Markdown 之间又有一些细微却也无法忽视的差异,这让需要在多个平台使用...Markdown 的我头疼不已,早就希望 GitHub Pages 能与 GitHub 的 Issues 和 comments 等地方统一语法,本次更新虽然做不到这一点,但也算是迈出了不小的一步。...之后的配置如下: markdown: kramdown kramdown: input: GFM highlighter: rouge 切换过程中有若干需要处理的差异问题,现将它们及解决方法记录如下...列表项里嵌套的代码块 嵌套在列表项中的代码块在 Redcarpet 中使用 Tab 进行缩进即可,而在 kramdown 中需要根据列表项的内容开始位置决定缩进的字符数。
kramdown 的列表嵌套内容的缩进规则很「奇葩」,不是使用自然的 Tab 缩进。...问题 kramdown 的作者对列表嵌套内容的缩进规则的 描述 是: kramdown does not allow 4 space indent, …… Indentation for list items...在年初 GitHub 宣布 GitHub Pages 服务将只支持 kramdown 这个 Markdown 解析引擎时,我曾经总结过从 Redcarpet 迁移到 kramdown 需要做的一些更改,...将 GitHub Pages 从 Redcarpet 切换到 kramdown 里有说到,嵌套在列表项里的代码块,如果不按如上规则做缩进的话,将会解析不正常。...当然这是最简单的一级嵌套的情况,如果是多级列表嵌套,那情况就更复杂了,每一次都去手打空格缩进吗?作为一名 Vimer,当然 say no!
kramdown 的列表嵌套内容的缩进规则很「奇葩」,不是使用自然的 Tab 缩进。...问题 kramdown 的作者对列表嵌套内容的缩进规则的 描述 是: kramdown does not allow 4 space indent, …… Indentation for list...在年初 GitHub 宣布 GitHub Pages 服务将只支持 kramdown 这个 Markdown 解析引擎时,我曾经总结过从 Redcarpet 迁移到 kramdown 需要做的一些更改,...将 GitHub Pages 从 Redcarpet 切换到 kramdown 里有说到,嵌套在列表项里的代码块,如果不按如上规则做缩进的话,将会解析不正常。...当然这是最简单的一级嵌套的情况,如果是多级列表嵌套,那情况就更复杂了,每一次都去手打空格缩进吗?作为一名 Vimer,当然 say no!
其中,markdown 字段的值表示使用哪一款插件来将 Markdown 文本转换为 HTML 页面结构。 GitHub 推荐使用的 Jekyll 的 Markdown 插件为 kramdown。...kramdown 是一个强大且高性能的文本转换引擎,你可以通过阅读 kramdown 和 markdown 较大的差异比较 - Hom 了解 kramdown 的强大之处。...: GFM 指的是 GitHub Flavored Markdown Spec。...风格的样式到 assets/css/syntax.css 文件中: $ rougify style github > assets/css/syntax.css 别忘了在你的 中把这份...以下每张图片的后面都标注了这种风格主题再 rouge 中的名称,使用上一节中提到的命令可以生成语法高亮样式。 ? ▲ github 需要额外设置前景色 #24292e ?
但是,Markdown 语法的出现无疑为博客编辑带来了一种全新的体验。按照规范化的文本内容标记编写,使用不同的 Markdown 语法翻译器和 CSS 样式,就可以带来丰富多彩的效果呈现。...之前 Github 的这个域名还是不提供 CDN 功能的,现在看起来像是有了所谓的 CDN 功能,但是实际的效果不得而知,因为笔者试着使用不同国家 IP 访问得到的地址都是美国的。...recommend-condition-size: 12 # a tag will be recommended if the size of it is more than this value # Build settings # 文章列表展示页每页显示的文章数量...', 'gulpfile.js', '.gitignore', 'README.md'] # Markdown 翻译器和语法着色工具 markdown: kramdown highlighter: prism...kramdown: input: GFM # 是否开启 RSS 订阅 RSS: true # Plugins 编译时所需的 Jekyll 插件 plugins: [jekyll-paginate
/09/16: GitHub Pages 现在已经改为只支持 kramdown),而其它放在 GitHub 仓库里的文档使用 GFM,我决定为我常用的 Markdown 编辑器 Vim 做一款同时支持...GFM 和 Redcarpet 两种 TOC 链接风格的 Table of Contents 自动生成插件。...下载地址 vim-markdown-toc 功能 为 Markdown 文件生成 Table of Contents,目前支持 GFM 和 Redcarpet 两种链接风格。...适用于 GitHub 仓库里的 Markdown 文件,比如 README.md,也适用用于生成 GitBook 的 Markdown 文件。...:GenTocRedcarpet 生成 Redcarpet 链接风格的 Table of Contents。
preface 最近又在看深度学习相关的内容,并且讲学习笔记呈现在了博客上,课程中有很多的公式,之前都是靠着截图的,但是这样就太繁琐了,想着如果能够直接敲公式的话效率就会高点了,就去看了一下 LaTeX...的语法,好像挺简单的,就稍微学习了一下,想发布到博客上发现渲染不出来 solution 博客是用 MarkDown 编写的,而 MarkDown 本身并不支持公式,但是我使用的 Typora 编辑器可以扩展...这在 Typora 里面是没有任何问题的,可以正常显示,但是 push 到基于 Jekyll 模板的 GitHub page 上就出现了不能渲染公式的问题,网上搜了一下,Jekyll 模板确实不支持...LaTeX 公式,不过有一种解决方法,那就是引入外部的 js脚本,可能会影响一点加载速度,但是我也没有什么明显的感觉(可能因为我挂着全局代理) 具体方法就是,到 _config.yml 中加上一行 markdown...: kramdown ,再打开 _includes 文件夹中的 head.html ,将下面这段脚本粘贴进去,提交修改,就可以正常渲染 LaTeX 公式了 <script type="text/x-mathjax-config
本文记录使用Mou和Stackedit中出现的一些问题,使其能够正常渲染带数学公式的文章 如果Mou渲染Math公式有问题的话,尝试在第一行加上如下js,表示让Mou去加载Mathjax的脚本 kramdown代替默认的rdiscount,然后在footer.html中加入上面的脚本内容。...过去的内容,也许不对… [但是,它还是存在些问题,关于inline Math公式的问题,推荐将Octopress中的Markdown引擎换成Kramdown,参考教程,另外,使用inline Math...Stackedit支持直接将文档publish到Github的某个项目的某个分支下的某个文件夹中,文件名自己命名。如下图所示: ?...我使用的方法是Import from URL功能,其中的URL是该Markdown文档的URL,可以在Github中找到并打开那个文档,点击Raw按钮就会进入这份文档的源代码页面,复制该页面的URL即可
它有一个模版目录,其中包含原始文本格式的文档,通过一个转换器(如 Markdown)和我们的 Liquid 渲染器转化成一个完整的可发布的静态网站,你可以发布在任何你喜爱的服务器上。...创建一个 Github 库并开启 Github Pages 首先我们用自己的 Github 账号创建一个新的库(repository),这个库的名称有固定的格式: username.github.io,..._config.yml里相关的参数如下: markdown: kramdown highlighter: rouge kramdown: input: GFM 根据上面的教程,我们已经配置好 Ruby...在本地博客文件的根目录里打开命令行,使用命令rougify style github > css/syntax.css生成一个 github 风格的样式到css/syntax.css文件中。...这里有你想要的 Rouge 主题 ----
Emacs的Org-mode是强大的,但没有很好的客户端工具,用来在不同的设备上同步我们的笔记。不过我们也可以把Emacs的笔记直接放到GitHub上,GitHub也是支持.org格式的文档的。...接下来说说云笔记的好处有哪些。它的好处不用多说,我认为最大的好处是:一处书写,到处可见。这是很屌的。...简单 列表连数字都自动排好 无序列表 无序列表 嵌套列表 自动缩进 上述的MarkDown格式为: #### 这是四级标题 一般写文章或论文,三级标题就够用了。不是吗?...列表连数字都自动排好 * 无序列表 * 无序列表 * 嵌套列表 * 自动缩进 代码一览 如果要插入一段代码块,可以把代码放到一对"`"中即可。...在MarkDown中,要想强调文字,如果要想把强调的文字以斜体的形式呈现,只需要把要强调的文字放到一对*或一对_之间即可。
支持html和css (三)GitHub 风格的表格 使用示例: | Tables | Are | Cool | | ------------- |:--------...GitHub 风格的表格示例 (四)Emoji 使用示例: :tada: :100::fire: 使用效果如下图所示: ?...Matter设置: 选项 写法示例 作用 navbar navbar: false false表示:禁用页面的导航栏 sidebarDepth sidebarDepth: 2 设置侧边栏的嵌套的标题链接最大深度...nav下拉列表 你还可以通过嵌套的 items 来在 下拉列表 中设置分组,如下所示: module.exports = { themeConfig: { nav: [ {...侧边栏标题优先级 可以通过上文提到的 YAML front matter 来设置侧边栏的嵌套的标题链接最大深度。
gem install pygments.rb 然后是修改 _config.yml 配置文件,其中的 highlighter 修改如下: markdown: kramdown highlighter...另外,Rouge 的主题和 Pygments 是完全兼容的,所以如果是从 Pygments 变到 Rouge,只需要在 _config.yml 配置文件做如下修改即可: markdown: kramdown...由于 Markdown 语言解析器对 Markdown 标准支持的不同,可能不支持 LaTex 公式,本站所使用的主题原来就尚未对 Markdown 公式或者 LaTex 公式进行支持。...毕竟中英文字符还是有差别的嘛。这个问题在参考资料的博文中做了一些比较深刻的讨论,最后给出来的方案就是这里采用的方案。...这个问题其实主要还是在统计上,由于这些非可计数内容不在正常字数统计内,也无法根据它们的数量来评估对应所需的时间,自然也不能加入到阅读时长里。
github pages 一直想添加代码高亮 highlighter ,基于 jekyll 3.0 的 rouge 终于搞定了: ?...下载代码高亮库 在 cmd 中输入: rougify style monokai.sublime > rouge.css 可以下载 rouge.css 出来,将这个 css 文件放到 github pages..._config.yml 中添加这些: markdown: kramdown kramdown: syntax_highlighter: rouge 将博文 md 文件中的 ``` 替换为 ~~~ruby...SourceElement().parentNode.className+=' has-jax';}}); 在 cmd 中输入 jekyll server,本地打开 127.0.0.1:4000 查看代码是否高亮了...,可以在我的 github pages 代码中查看具体的详情
图4 基于Ol()与Li()渲染有序列表 利用Ol()嵌套多个Li(),可以自动渲染出带序号的有序列表,就像下面这个简单的例子: app4.py import dash import dash_html_components...图5 基于Ul()与Li()渲染层级列表 而除了与Ol()相互配合之外,Li()还可以嵌套在Ul()中渲染带层级关系的列表: app5.py import dash import dash_html_components...图10 2.2 dcc.Markdown()——Dash中特殊的静态部件 在Dash中还存在一个比较特别的用于呈现静态内容的部件——dcc.Markdown(),它的children参数接受markdown...代码,并自动在网页中呈现出渲染后的效果,其主要参数如下: children:字符型markdown源码 dangerously_allow_html:bool型,用于设置是否允许解析出markdown...图11 有了Markdown()部件的加持,我们就可以在某些情况下直接利用markdown快速编写网页,譬如编写在线文档说明页面~ 3 利用Dash自制在线Markdown编辑器 在掌握了今天的教程所涉及知识之后
Blockquote()实现块引用」 利用dash_html_components中的Blockquote(),我们可以直接传入字符串,或嵌套其他元素,从而构造出块引用,就像markdown中的>所包含渲染的内容那样...」 利用Ol()嵌套多个Li(),可以自动渲染出带序号的有序列表,就像下面这个简单的例子: ❝app4.py ❞ import dash import dash_html_components as html...」 而除了与Ol()相互配合之外,Li()还可以嵌套在Ul()中渲染带层级关系的列表: ❝app5.py ❞ import dash import dash_html_components as html...()——Dash中特殊的静态部件 在Dash中还存在一个比较特别的用于呈现静态内容的部件——dcc.Markdown(),它的children参数接受markdown代码,并自动在网页中呈现出渲染后的效果...,其主要参数如下: ❝「children」:字符型markdown源码 「dangerously_allow_html」:bool型,用于设置是否允许解析出markdown源码中的html代码并渲染,默认为
当前许多网站都支持用 Markdown 来撰写文档 如 博客园、CSDN、简书、语雀 等,有了这么多网站的支持,你可以随时随地上传本地 MarkDown 文件到博客中 MarkDown 基本语法 一、...[alt](图片地址 ''title'') alt 指的是当图片链接失效时显示的提示文字,可加可不加 title是图片的标题,当鼠标移到图片上时显示的内容,可加可不加 如果你想要调整图片大小,有两种方式...硬换行:你可以通过 空格+ 空格+ shift+enter完成一次硬换行,而这也是许多 Markdown 编辑器所原生支持的。硬换行在文档被导出时将被保留,且没有换段的段后距。...Windows 风格(CR+LF)与 Unix 风格(LF)的换行符:CR表示回车\r,即回到一行的开头,而LF表示换行\n,即另起一行。...所以 Windows 风格的换行符本质是「回车+换行」,而 Unix 风格的换行符是「换行」。这也是为什么 Unix/Mac 系统下的文件,如果在 Windows 系统直接打开会全部在同一行内。
GFM 即 GitHub Flavored Markdown,是 GitHub 用在 Respository、Issues、Comments 和 Pull requests 里的一种 Markdown...在这里做个小广告:如果你使用 Vim 编辑 Markdown,那可以试试我写的能自动生成 GFM 和 Redcarpet 这两种风格 TOC 的 Vim 插件 vim-markdown-toc。...和空格替换为 -,有两个及以上 - 的地方修复成一个,将链接串首尾的 -_ 删除。 列表下嵌套内容 在 Redcarpet 中有如下规则: 如果嵌套非列表,需要缩进并且空行。...如果嵌套列表,需要缩进,但不空行。 而 GFM 则没有。...Task Lists 这货真是个好东西,用 - [ ] 和 - [ x ] 就能做出清单列表项的显示效果来,而且如果你有编辑权限的话点选后文本能自动更新。 ?
GitHub Pages 更新 由 Ghostzhang 发表于 2016-05-07 02:26 有段时间没有更新了,没想到一更新就收到GitHub的邮件,说是系统升级了,因为使用了一些旧的功能,...首先,看看这次系统升级了些什么,根据邮件指示,来到了这里:GitHub Pages now faster and simpler with Jekyll 3.0,大概的意思是GitHub Pages更新到...Jekyll 3.0了,有以下几点变动: 2016年5月1号开始,GitHub Pages只支持kramdown,作为Jekyll的默认Markdown引擎,如果你用的是其它的引擎,那么你有三个月时间进行更新...原先如果使用{% highlight js %} code {% endhighlight %} 的方式进行代码高亮,那么就得修改啦,用```即可,详见 https://help.github.com...Jekyll 3.0对本地版本的优化,我没有使用过,不太了解,有兴趣的同学自己到上面的链接看吧。
领取专属 10元无门槛券
手把手带您无忧上云