/ / Formatowanie Markdown: jak mogę dodać ciąg po liście wypunktowanej? - github, wyprzedaż, nowa linia

Formatowanie Markdown: jak mogę dodać ciąg po wypunktowanej liście? - github, markdown, newline

Edytuję stronę wiki GitHub przy użyciu trybu edycji Markdown.

Źródło jest następujące:

Parameters:
* ```param1```: string, contains a parameter
* ```param2```: string, contains a parameter
* ```param3```: string, contains a parameter, could be:
- `ONE`: one element.
- `TWO`: two elements.

Wynik jest następujący:

  • param1: string, zawiera parametr
  • param2: string, zawiera parametr
  • param3: string, zawiera parametr, może być:
    • ONE: jeden element.
    • TWO: dwa elementy.

Teraz chciałbym dodać następujące zdanie, jako dodatkowe wyjaśnienie param3: "param3 może być pustym ciągiem ”, aby zdanie było wyrównane do trzeciej kropki (przed param3).

Najlepsze rozwiązanie, jakie znalazłem, to:

  • param1: string, zawiera parametr
  • param2: string, zawiera parametr
  • param3: string, zawiera parametr, może być:

    • ONE: jeden element.
    • TWO: dwa elementy.

    param3 może być pustym ciągiem

Ale z jakiegoś powodu dodaje dodatkowe miejsce powyżej „- ONE: jeden element. ”.

Nie mogę znaleźć właściwej składni ani w GitHub, ani w Stack Overflow.

Odpowiedzi:

0 dla odpowiedzi № 1

Powinieneś przesunąć akapit w prawo z niełamliwymi spacjami, aby dopasować go do elementów listy najwyższego poziomu.

 - `param1`: string, contains a parameter
- `param2`: string, contains a parameter
- `param3`: string, contains a parameter, could be:
- `ONE`: one element.
- `TWO`: two elements.

       `param3` could be an empty string

Wynik:

  • param1: string, zawiera parametr
  • param2: string, zawiera parametr
  • param3: string, zawiera parametr, może być:
    • ONE: jeden element.
    • TWO: dwa elementy.

param3 może być pustym ciągiem


0 dla odpowiedzi nr 2

Problem polega na tym, że mieszasz elementy listy „luźne” i „ciasne” ... a Stackoverflow ma dziwne reguły CSS.

„Ścisła pozycja listy” to pozycja listy, która nie jest zawijana w akapicie (<p>) w danych wyjściowych HTML. Ścisła lista jest tworzona przez pominięcie pustych linii między elementami.

Na przykład ta lista:

* item one
* item two

... jest renderowany jako ten HTML:

<ul>
<li>item one</li>
<li>item two</li>
</ul>

Zauważ, że nie <p> tagi pojawiają się na tej liście.

Luźne listy

„Luźna pozycja na liście” to lista, w której każdy element jest zawijany w akapicie (<p>) w danych wyjściowych HTML. Luźna lista jest tworzona przez umieszczenie pustej linii między każdym elementem listy.

Na przykład ta lista:

* item one

* item two

... jest renderowany jako ten HTML:

<ul>
<li><p>item one<p></li>
<li><p>item two<p></li>
</ul>

Pamiętaj, że zawartość każdego elementu listy <li> jest zawinięty w

etykietka. Zasadniczo powodowało to wyświetlanie dodatkowych białych znaków w przeglądarce. Na przykład tutaj w Stackoverflow zdefiniowano następującą regułę CSS:

p {margin-bottom: 1em;}

Ta reguła powoduje szeroki dolny margines, który oddziela akapit od następującej po nim treści. Jednak ta reguła nie jest stosowana do elementów listy ścisłej (ponieważ nie ma <p> tag) i są znacznie bliżej siebie.

Masz listę „mieszaną”

„Lista mieszana” to lista obejmująca oba typy elementów. Niektóre przedmioty są zapakowane <p> tagi, a niektóre nie. Ważne jest, aby pamiętać, że każdy element listy, który zawiera elementy zagnieżdżone, jest „luźnym elementem listy”. Jednak pozostałe elementy są „wąskimi elementami listy” iz tego powodu masz listę mieszaną, która wydaje się niespójna. Potrzebujesz aby wszystkie przedmioty były „ciasne” lub „luźne”. Oczywiście, ponieważ nie masz innego wyboru, jak uczynić trzeci przedmiot „luźnym” (ponieważ zawiera elementy zagnieżdżone), musisz uczynić wszystkie przedmioty „luźnymi”. pomaga luźno zagnieżdżoną listę podrzędną.

Lubię to:

Parameters:

* `param1`: string, contains a parameter

* `param2`: string, contains a parameter

* `param3`: string, contains a parameter, could be:

- `ONE`: one element.

- `TWO`: two elements.

`param3` could be an empty string

Ale to nie działa na Stackoverflow ...

Stackoverflow ma tę (dziwną, IMO) regułę CSS:

ul p.last-of-type {margin-bottom: 0;}

Co powoduje, że ostatni akapit listy nieuzyskać szeroki dolny margines. Oczywiście akapit następujący po zagnieżdżonej liście jest wtedy naprawdę blisko zagnieżdżonej listy powyżej, zamiast utrzymywać takie same odstępy jak wszystkie inne elementy na liście. Z powodu tej reguły nic nie można zrobić, aby „naprawić” problem, poza błaganiem deweloperów stackoverflow, aby zmienić CSS (przynajmniej reguła powinna mieć zastosowanie tylko do list na poziomie głównym pytania / odpowiedzi, ale nie do zagnieżdżonych list).

Na szczęście nie wszystkie witryny używają tej niezwykłej reguły, a luźna lista na innych stronach powinna być bardziej spójna.