Инструменты форматирования текста

14

Я делаю заметки в текстовом формате, например:

## Список дел
1. сделать это
2. сделать это

## ЧТО НИБУДЬ
### ЧТО-НИБУДЬ
1. сделать это
2. сделать это

Существуют ли инструменты для преобразования этого текста в формат HTML или LaTeX? Я нахожу Sphinx , так как он для форматирования кода Python. Было бы здорово, есть инструмент для более общего форматирования текста.

software-rec formatting text-processors prosseek
источник

Ответы:

30

Прошло уже почти восемь лет с тех пор, как я написал ответ ниже, я больше не использую Grutatxt и теперь почти исключительно использую MultiMarkdown, который добавляет ряд полезных расширений в Markdown - расширенная функция, которую я использую чаще всего, - это таблицы.

Существует ряд расширений для Markdown, которые не на 100% совместимы, но которые можно использовать практически взаимозаменяемо, если вы позаботитесь об использовании общего подмножества функций.

  • MultiMarkdown
  • Markdown со вкусом Github
  • PHP Markdown Extra

Существует хорошая поддержка надмножеств Markdown во многих приложениях и языках. Я использовал поддержку PHP, Perl и Go (golang) для расширенной Markdown

Существует множество настольных и мобильных приложений, которые поддерживают редактирование Markdown с предварительным просмотром в реальном времени и т. Д. Я все еще использую простой текстовый редактор.

Лично я не использую Pandoc, но считаю, что он в хорошем состоянии и, вероятно, самый универсальный облегченный процессор разметки. Это должно быть в чьем-либо списке.

Я предлагаю начать с рассмотрения Markdown , Textile и Grutatxt . Но есть много:

Список простой текстовой разметки и инструментов

Другие списки

Grutatxt

Мне нравится Grutatxt, потому что он кажется мне ближе к простому тексту без украшений, и поэтому простой текст очень удобочитаем. Я использую GrutaTxt для генерации HTML и PDF (через LaTeX). Он хорошо обрабатывает таблицы, чего не делает Markdown, насколько я знаю. У меня есть скрипт Perl для добавления оглавления и подключения таблицы стилей CSS. Я использую перекодировать для преобразования кодировки символов в UTF8. У меня есть все это в простом make-файле, поэтому я могу просто отредактировать текстовый файл и напечатать, makeчтобы опубликовать его как веб-страницу (и PDF одновременно).

Сравнение разметки для GrutaTxt, ASCIIDOC и APT

NL= новая строка, SP= пробел (ы)

Title
  Markdown      Title NL =====
  Grutatxt      Title NL =====
  ASCIIDOC      Title NL =====
  APT           --- NL Title NL --- NL Author NL --- NL Date

H1
  Markdown      Head NL ====   or # Head #
  Grutatxt      Head NL ====
  ASCIIDOC      Head NL ----   or   == Head
  APT           * Head

H2
  Markdown      Head NL ----   or ## Head ##
  Grutatxt      Head NL ----
  ASCIIDOC      Head NL ~~~~   or   === Head
  APT           ** Head

H3
  Markdown      ### Head ###
  Grutatxt      Head NL ~~~~
  ASCIIDOC      head NL ^^^^   or   ==== Head
  APT           *** Head

H4
  Markdown      -
  Grutatxt      -
  ASCIIDOC      Head NL ++++   or   ===== Head
  APT           **** Head       

Bold
  Markdown      **word**
  Grutatxt      *word*
  ASCIIDOC      .word
  APT           <<word>>

Italic
  Markdown      *word*
  Grutatxt      _word_
  ASCIIDOC      -
  APT           <word>

Code
  Markdown      `words`
  Grutatxt      `words'
  ASCIIDOC      `words`
  APT           <<<words>>>

Line Break
  Markdown      words SP SP NL
  Grutatxt      -
  ASCIIDOC      -
  APT           words \ NL words

Non breaking space
  Markdown      -
  Grutatxt      -
  ASCIIDOC      -
  APT           word\ word

Comment
  Markdown      -
  Grutatxt      -
  ASCIIDOC      -
  APT           ~~ comments

HyperLink
  Markdown      [name](http://a.b.c)
  Grutatxt      http://a.b.c(name)
  ASCIIDOC      <<a.b.c, name>>
  APT           http://a.b.c
                {{{http://a.b.c}name}}

Anchor
  Markdown      -
  Grutatxt      -
  ASCIIDOC      [[name]]
  APT           {name}

Unordered List
  Markdown      SP SP - words
  Grutatxt      SP * words
  ASCIIDOC      SP - words
  APT           SP * words

Ordered List
  Markdown      SP SP 1. words
  Grutatxt      SP # words
  ASCIIDOC      -
  APT           [[1]] words

Definition
  Markdown      -
  Grutatxt      SP * term: definition
  ASCIIDOC      term:: NL definition
  APT           [term] definition

Table
  Markdown      -
  Grutatxt      +---+---+
                | a | b |
                +---+---+
  ASCIIDOC      ~~~~~
                h,h,h
                ~~~~~
                a,b,c
                d,e,f
                ~~~~~
  APT           *---*---+---:
                |ctr|lft|rgt|
                *---*---+---:
                caption

Image
  Markdown      ![alt](http://a.b.c.png)
  Grutatxt      << NL <img src="cow.jpg" /> NL >>
  ASCIIDOC      -
  APT           [cow.jpg] caption

Preformatted
  Markdown      SP SP SP SP words    or <pre> NL words NL </pre>
  Grutatxt      SP words
  ASCIIDOC      SP words
  APT           --- NL words NL ---

Horizontal Rule
  Markdown      NL ------ NL      
  Grutatxt      ____
  ASCIIDOC      -
  APT           ====

Citation
  Markdown      -
  Grutatxt      ``words
  ASCIIDOC      -
  APT           -
RedGrittyBrick
источник
reStructuredText - самый популярный проект по формированию тестов. PDF / HTML / слайды. Содержание, автономные указатели, печатные книги. Может быть преобразован в любой другой формат с помощью Pandoc . Только не используйте слабое форматирование Markdown ...
gavenkoa
0

Орг-режим выглядит идеально.

Ваша разметка уже очень похожа, и в режиме org есть много форматов вывода, включая те, которые соответствуют вашим требованиям.

johntait.org
источник