New optional markdown=True parameter for to the cell, multi_cell & write methods ( close #108 )

that enable basic Markdown-like styling: `**bold**, __italics__, --underlined--`

Author: Lucas-C

CHANGELOG.md

@@ -12,8 +12,11 @@ and [PEP 440](https://www.python.org/dev/peps/pep-0440/).
 - now `fpdf2` uses the newly supported `DCTDecode` image filter for JPEG images,
   instead of `FlateDecode` before, in order to improve the compression ratio without any image quality loss.
   On test images, this reduced the size of embeded JPEG images by 90%.
-- `FPDF.cell`: the `w` parameter becomes optional, with a default value of `None`, meaning to generate a cell with the size of the text content provided, and the `h` default value changes, becoming `None`, meaning to get its value from the current font size
+- `FPDF.cell`: the `w` (width) parameter becomes optional, with a default value of `None`, meaning to generate a cell with the size of the text content provided
+- the `h` (height) parameter of the `cell`, `multi_cell` & `write` methods gets a default value change, `None`, meaning to use the current font size
 ### Added
+- a new optional `markdown=True` parameter can be passed to the `cell`, `multi_cell` & `write` methods
+  in order to enable basic Markdown-like styling: `**bold**, __italics__, --underlined--`
 - `FPDF.cell`: new optional `center` parameter to position the cell horizontally
 - `HTMLMixin` / `HTML2FPDF`: now support `align="justify"`
 - new method `FPDF.image_filter` to control the image filters used for images

docs/TextStyling.md

@@ -41,3 +41,19 @@ pdf.write_html("""<B>bold</B>
                   <B><I><U>all at once!</U></I></B>"""
 )
 ```
+
+
+## markdown=True ##
+
+An optional `markdown=True` parameter can be passed to the `cell`, `multi_cell` & `write` methods
+in order to enable basic Markdown-like styling: `**bold**, __italics__, --underlined--`
+
+```python
+from fpdf import FPDF
+
+pdf = fpdf.FPDF()
+pdf.add_page()
+pdf.set_font("Times", size=60)
+pdf.cell(txt="**Lorem** __Ipsum__ --dolor--", markdown=True)
+pdf.output("markdown-styled.pdf")
+```

docs/reference/write.md

@@ -1,43 +1,6 @@
-## write ##
+cf. https://pyfpdf.github.io/fpdf2/fpdf/#fpdf.FPDF.write
 
-```python
-write(h: float, txt: str, link)
-```
-
-### Description ###
-
-This method prints text from the current position. When the right margin is 
-reached (or the \n character is met), a line break occurs and text continues 
-from the left margin. Upon method exit, the current position is left just at 
-the end of the text.
-
-It is possible to put a link on the text.
-
-### Parameters ###
-
-h:
-> Line height.
-
-txt:
-> String to print.
-
-link:
-> URL or identifier returned by [add_link](add_link.md).
-
-### Example ###
-```python
-# Begin with regular font
-pdf.set_font('helvetica', '', 14)
-pdf.write(5, 'Visit ')
-# Then put a blue underlined link
-pdf.set_text_color(0, 0, 255)
-pdf.set_font('', 'U')
-pdf.write(5, 'pyfpdf.github.io/fpdf2/', 'https://pyfpdf.github.io/fpdf2/')
-```
-
-### See also ###
-
-[set_doc_option](set_doc_option.md), [set_font](set_font.md), 
-[set_text_color](set_text_color.md), [add_link](add_link.md), 
-[multi_cell](multi_cell.md), [set_auto_page_break](set_auto_page_break.md), 
-[write_html](write_html.md)
+<script>
+// Migrating Markdown doc to docstrings - cf. https://github.com/PyFPDF/fpdf2/issues/31
+window.location = 'https://pyfpdf.github.io/fpdf2/fpdf/#fpdf.FPDF.write'
+</script>