标签: markdown

我需要创建一个大文档，打印时将有几百页。我想用 Markdown 之类的东西来做到这一点。我的要求之一是文档必须有页码和目录。有没有办法使用 Markdown 或类似的标记语言来自动生成带有关联页码的目录？到目前为止，我使用 Markdown 看到的所有内容都可以自动生成 HTML 输出的目录，但没有关联的页码。

我有一个如下所示的文件夹结构：

chapters/
  01-chapter.md
  02-chapter.md
  03-chapter.md
format.sh
parse.sh

解析器

chapters/
  01-chapter.md
  02-chapter.md
  03-chapter.md
format.sh
parse.sh

格式.sh

pandoc -t html5+smart -so dist/book.html --html-q-tags chapters/*.md

我的想法基本上是不仅使用 Pandoc 作为转换器，而且还作为格式化程序 - 这工作得很好，直到我开始使用脚注：

当我运行format.sh时，我用于脚注的每个引用名称都会被数字覆盖 - 这很好，但问题是如果我运行parse.sh我会收到以下消息：

[WARNING] Duplicate note reference '1' at line 360 column 1

问题是01-chapter.md和02-chapter.md都有脚注[^1]。基本上我希望 Pandoc 单独处理每个文件的脚注，并且不允许在我的 markdown 文件之间交叉引用，但我看不到任何方法可以做到这一点。

有人有什么想法吗？

如果 Markdown 文件包含图像，如何将其转换为 pdf？有许多工具可以执行 .md 到 .pdf 转换，但如果 markdown 中有任何图像，它们不会出现在最终的 pdf 中，而是显示替代文本。

例如，以下是 .md 在 Visual Studio Code 中预览的方式：

上面的内容在 pdf 中是这样的：

已尝试使用以下内容： https: //www.markdowntopdf.com/

该安装说明（GIT：//gitorious.org/python-markdown/mainline.git）的文件中说，using_as_module.txt

您可以传递的参数之一是扩展列表。扩展必须在markdown.extensions 包内或 PYTHONPATH 上作为 python 模块提供 ，名称以 开头mdx_，后跟扩展名。因此，extensions=['footnotes']将首先查找模块markdown.extensions.footnotes，然后是名为 mdx_footnotes. 请参阅特定于您正在使用的扩展的文档，以获得指定该扩展的配置设置的帮助。

我将文件夹“extensions”放到 ~/bin/python/ 中，这样我的 PYTHONPATH 如下

export PYTHONPATH=/Users/masi/bin/python/:/opt/local/Library/Frameworks/Python.framework/Versions/2.6/

说明说我需要导入插件

import markdown
import <module-name>

但是，我在 Python 中看不到任何模块。这表明扩展不能作为“python 模块 - - 在 [my] PYTHONPATH 上，名称以 mdx_ - - 开头”。

如何让 Markdown 的扩展工作？

第二次尝试

我在 ~/bin/markdown 运行

git clone git://gitorious.org/python-markdown/mainline.git python-markdown
cd python-markdown
python setup.py install

我将该文件夹放到了/Users/masi/bin/markdown/python-markdown/build我的 PATH 中，因为安装消息提示我这是扩展的新位置。

我在测试降价文档中有以下内容

[TOC]
-- headings here with # -format ---

但是，我没有得到目录。这表明我们在通过 markdown.py …

在 Markdown 规范中：

\n

对于 Markdown\xe2\x80\x99s 语法未涵盖的任何标记，您只需使用 HTML 本身即可。\xe2\x80\x99s 不需要在它前面加前缀或分隔它来表明你\xe2\x80\x99 正在从 Markdown 切换到 HTML；你只需使用标签。

\n\n

唯一的限制是块级 HTML 元素 \xe2\x80\x94 例如 <div>、<table>、<pre>、<p> 等。 \xe2\x80\x94 必须用空行与周围内容分隔开，并且块的开始和结束标记不应使用制表符或空格缩进。

\n

源代码： http: //daringfireball.net/projects/markdown/syntax

我想知道是否有任何程序/工具/API 可以用来处理这个问题？我想解决这个问题，因为我想将我的博客从Drupal转换为Octopress。

我想知道是否有一个 PHP Web 应用程序，例如

• 当用类似的东西调用时http://example.com/index.php?inputfile=mymarkdownfile.txt；它将在与网络服务器上mymarkdownfile.txt相同的位置打开文件index.php，并将其呈现为 Markdown（即，它将 Markdown 转换为 HTML 并提供它）
• 将有一个“编辑”按钮，它会打开一个“实时预览”Markdown 编辑器（如 StackExchange/StackOverflow 网站上的）
• 当您完成编辑并单击“保存”按钮后，以前的版本将在服务器上存档（保存为文本文件mymarkdownfile-时间戳.txt），更改后的版本保存为mymarkdownfile.txt.
• 如果您尝试“打开”一个“不存在的文件”（比如 viahttp://example.com/index.php?inputfile=nonexistant.txt），那么编辑器首先启动；并且在那里输入的内容将保存为nonexistant.txt（和nonexistant-时间戳.txt）

我只需要这个用于基于服务器的笔记，我真的不需要本地链接或类似的东西；也不是用户身份验证或保护（我打算在本地网络上使用它，所以我不会担心“编辑”按钮和故意破坏的公开曝光）。

我想它可能是一个 PHP 页面，它使用：

• 首次读取页面请求时用于初始转换为 HTML 的PHP Markdown库
• pagedown -编辑器处于活动状态时的JavaScript Markdown 转换器和编辑器（另请参阅是否有任何好的 Markdown Javascript 库或控件？ - 堆栈溢出）。

外面有这样的吗？

非常感谢您提供任何答案，
干杯！

我正在尝试使用 pandoc 和特殊的 MS Word 模板将 txt 文件（markdown）转换为 docx。我这样做：

pandoc -s --reference-docx=/path/to/my/template.dotx -o outfield.docx file.md

问题是我已经用特殊的“正文段落”样式设置了模板，与“正常”样式分开（因为各种标题等都基于“正常”样式。有没有办法告诉pandoc 当它转换普通段落文本时，应该使用我特殊的“正文段落”样式来设置样式？

我刚刚安装了Jekyll，当我jekyll在一个包含一些.html.md文件的目录上运行时。但它没有将其转换为.html文件。Jekyll 只是将这些文件_site按原样复制到目录中。

我添加_config.yml并添加

markdown:        maruku

但它仍然不会将 Markdown 转换为 HTML。

我应该怎么做才能让它发挥作用？

目前我经常使用 Thunderbird 来发送和接收代码块，有时还有调试信息。Thunderbird 是否有 StackOverflow 风格的降价？

Windows 可以在不使用其他软件的情况下打开 Markdown 文件吗？Windows 7 和 Windows 10 之间有区别吗？

我想知道在将 Markdown 文件发送给非技术 Windows 用户之前是否必须将其转换为其他文件，但我现在无法访问 Windows PC。