-> Japanese version (original)
BlueFeather is software for converting text written by extended Markdown like PHP Markdown Extra to html. It is pair of command-line tool and pure Ruby library. For details, please see the BlueFeather Manual.
BlueFeather requires ruby 1.8.0 later. Since BlueFeather 0.20, it has adapted to ruby 1.9.x series.
If RubyGems has been installed on your environment, you can install BlueFeather by the following way.
gem install bluefeather
And you can update already installed BlueFeather to newer version.
gem update bluefeather
You can convert Markdown text online only to push 'convert' button .
BlueFeather development repository is published on the project page on Launchpad. If Bazaar has been installed on your PC, you can get latest branch of BlueFeather by the following way.
% bzr branch lp:bluefeather
If you extend or fix to BlueFeather, let's propose for merging by Launchpad's function!
If you want to send requests, comments, or bug reports to BlueFeather, please feel free to post message by this form.
BlueFeather 0.40 was released.
Add "Header-ID-Type:"
header.
If its value is 'escape', automatic generated header ID varies.
Header-ID-Type: escape
Add new syntax sugar for anchor link. Following links are both equal.
[TargetHeader](#)
[TargetHeader](#TargetHeader)
'shift_jis' is enabled for encoding specification.
Fix problems
BlueFeather 0.34 was released.
Fix problems
Error is raised at invalid HTML-like text in code block
~~~~
f<a < b>(a)
~~~~
BlueFeather Online Converting was published.
BlueFeather 0.33 was released.
Fix problems
Table with left-space was not converted
|td1|td2|td3|
and other small problems
BlueFeather 0.32 was released.
Fix problems and misprint (Thanks to Masahiro Kitajima)
If path of source text file included \ symbol on Windows, bluefeather
command failed with "targets not found".
If multibyte string existed on title element in HTML document, browser might not load the document.
Span surrounded by double backtick (``) was not parsed as code. (Refer => Markdown Syntax - Code)
\ symbol in code block was not displayed.
Description and Keyword of document metadata didn't work.
The following text at first of a document was parsed as document metadata.
<h1>header:level1</h1>
# markdown:syntax
Metadata reference in japanese manual.
BlueFeather 0.31 was released.
Fix problems
One blank line becomes to two blank lines in code block on list item. In the following example, two blank lines are created between "code a" and "code b".
* example list
~~~
code a
code b
~~~
BlueFeather 0.30 was released.
Implement header numbering.
If you enable it, you write "Numbering: yes"
at the top of document. Refer to document metadata.
Change toc rule. Following format raises warning.
{toc}
# h1
### h3
Fix problems
One or some spaces disabled value at end of header line on document metadata. Following format was disabled.
Encoding: utf-8 (line break)
BlueFeather 0.22 was released.
fix: Parser#parse_document aborts
fix: Back quote escaping for auto-link fails
BlueFeather 0.21 was released.
Alter bluefeather command output.
If you specify -v (--verbose), bluefeather show encoding of each file at converting.
If you specify --version, bluefeather also show release date of this version.
Fix fenced code block bug that last line on 2-or-more lines block is wrongly converted. For example, #
symbol or :
symbol.
Fix bug that a document encoded by UTF-8 with BOM can't be correctly converted.
BlueFeather 0.20 was released.
Adapt to Ruby 1.9.x series.
Change encoding rule at parsing to html document. For details, see the Encoding Rule.
Extend TOC format for specifing header-level. You can write TOC as {toc:h3-h4}
or {toc:h3}
.
BlueFeather 0.20 fix1 was released.
BlueFeather 0.11 was released.
bluefeather
command converts only input files that were modified
and add --force
option.
In parsing URL auto-anchor, use URI.regexp
of uri.rb.
small fixes and new spec codes.
At the top of this page, mistake of link to BlueFeather Manual was fixed.
BlueFeather 0.10 (first) was released.