降价

下载

降价1.0.1（18 KB）-2004年12月17日

介绍

Markdown是一个用于web作者的文本到HTML转换工具。降价允许您使用易于阅读、易于编写的纯文本进行书写格式，然后将其转换为结构有效的XHTML（或HTML）。

因此，“标记”是两件事：（1）纯文本格式语法；（2）一个用Perl编写的软件工具，用于转换纯文本格式设置为HTML。请参阅语法有关的详细信息，请参见第页标记的格式语法。您可以立即使用联机丁格斯.

Markdown格式语法的首要设计目标是它尽可能可读。这个想法是，降价形成了文档应以as-is格式发布，以纯文本形式发布，无需查看就像它被标记了标签或格式说明。While期间Markdown的语法受到了几个现有的text-to-HTML的影响过滤器，Markdown的最大灵感来源语法是纯文本电子邮件的格式。

了解Markdown格式语法的最好方法是查看Markdown格式的文档。例如，您可以查看此页面上文章文本的降价来源：http://daringfireball.net/projects/markdown/index.text

（您可以使用此“.text”后缀技巧查看的标记源本节中每个页面的内容，例如语法和许可证第页。）

Markdown是一种自由软件，可在BSD风格的开放源代码下使用许可证。请参阅许可证第页了解更多信息。

讨论列表

我已经建立了一个公众讨论降价的邮件列表.与标记相关的任何主题-包括其格式语法和它的软件是一个值得讨论的游戏。任何感兴趣的人欢迎加入。

我希望邮件列表能为未来带来好主意对降价的改进。

安装和要求

降价需要Perl 5.6.0或更高版本。欢迎来到21世纪。降价还需要标准的Perl库模块摘要：：MD5，它可能已经安装在您的服务器上。

移动式

Markdown适用于Movable Type 2.6或更高版本（包括移动式3.0）。

  1. 将“Markdown.pl”文件复制到Movable Type“插件”中目录。“插件”目录应该在同一目录中作为“mt.cgi”；如果“插件”目录不存在，请使用您的FTP程序来创建它。您的安装应该如下所示这个：

    （mt home）/plugins/Markdown.pl

  2. 安装后，标记将显示为可移动类型的选项文本格式弹出菜单。这可以按成本选择：

    可移动类型“文本格式”菜单的屏幕截图

    当你发布时，标记会将你的帖子转换成HTML；柱子它们以降价格式存储在MT数据库中。

  3. 如果您也安装SmartyPants 1.5（或更高版本），Markdown将提供第二个文本格式选项：“标记方式SmartyPants”。此选项与常规“降价”相同格式化程序，除了它自动使用SmartyPants创建排版正确的大引号、em短划线和省略号。请参见这个SmartyPants网页了解更多信息。

  4. 将降价（或“SmartyPants降价”）设置为默认值新帖子的文本格式选项，请转到日志配置：偏好。

注意，默认情况下，Markdown会生成XHTML输出。要配置标记以生成HTML 4输出，请参阅下面的“配置”。

布洛克索姆

Markdown适用于Blosxom 2.0或更高版本。

  1. 将“Markdown.pl”插件重命名为“Markdown”（情况是重要）。可移动类型要求插件具有“.pl”延伸；Blosxom禁止这样做。

  2. 将“Markdown”插件文件复制到Blosxom插件文件夹。如果您不确定Blosxom插件文件夹的位置，请参阅Blosxom文档以获取信息。

  3. 就这样。您的日志中的条目现在将自动由Markdown处理。

  4. 如果您只想将标记格式应用于特定可以选择在中使用Markdown，而不是所有帖子与Blosxom合作元插件。首先，安装元插件。接下来，以文本形式打开Markdown插件文件编辑器，并设置配置变量$g_blossom_use_meta至1。然后，只需包含“meta-markup:降价“标题行在您使用Markdown撰写的每个帖子的顶部。

BB编辑

Markdown适用于Mac OS X上的BBEdit 6.1或更高版本。它也适用于在Mac OS 8.6或更高版本上使用BBEdit 5.1或更高，使用MacPerl 5.6.1。如果您运行的是Mac OS X 10.2（Jaguar），可能需要安装Perl模块摘要：：MD5来自CPAN；摘要：：MD5出现预安装在Mac OS X 10.3（Panther）上。

  1. 将“Markdown.pl”文件复制到您的“BBEdit Support”文件夹。在Mac OS X上，这应该是：

    BBEdit Support/Unix支持/Unix筛选器/

    有关位置的更多详细信息，请参阅BBEdit文档这些文件夹。

    您可以将“Markdown.pl”重命名为任意名称。

  2. 就是这样。要使用标记，请在BBEdit文档中选择一些文本，然后从“#！”菜单的“过滤器”子菜单中选择“标记”，或过滤器浮动调色板

配置

默认情况下，Markdown为带有空元素的标记生成XHTML输出。例如。：

<br/>

Markdown可以被配置为生成HTML样式的标签；例如。：

<br>

移动式

你需要用一种特殊的MTMarkdown选项每个中的容器标签需要HTML 4样式输出的可移动类型模板：

<MTMarkdownOptions输出='html4'>…将条目内容放在此处。。。</MT标记选项>

使用MTMarkdownOptions最简单的方法可能是将在您的后面打开标签<body>标记和右结束标记之前</body>.

抑制特定模板中的降价处理，即发布原始标记格式的文本，而不将其翻译为（十） HTML，设置输出属性设置为“raw”：

<MTMarkdownOptions输出=“raw”>…将条目内容放在此处。。。</MT标记选项>

命令行

使用--html4标签命令行开关，用于从Unix样式的命令行。例如。：

%perl标记.pl--html4标记foo.text

类型perldoc标记.pl，或阅读中的POD文档Markdown.pl源代码了解更多信息。

致谢

亚伦·斯瓦茨他对Markdown格式语法的设计。降价为许多的更好谢谢Aaron的想法、反馈和测试。还有Aaron的html2文本是一个非常方便（而且免费）的实用程序，用于将HTML转换为标记格式的纯文本。

纳撒尼尔铁杆,丹·本杰明,丹尼尔·博根、和杰森·珀金斯也值得感谢他们的反馈。

米歇尔·福廷已将Markdown移植到PHP；它是一个很棒的端口，强烈建议任何人寻找Markdown的PHP实现。