14

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

## TODO list
1. do this
2. do that

## SOMETHING
### ANYTHING
1. do this
2. do that 

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

3 ответа3

30

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

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

  • MultiMarkdown
  • Уценка 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           -
1

Другой формат - Текстиль. Уценка более или менее комильфо.

0

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

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

Всё ещё ищете ответ? Посмотрите другие вопросы с метками .